Browser Batteries: NodeJS im Gepäck
Das 'Batteries-included'-Paket der Browser Library unter der Lupe

Das “Browser-Batteries”-Package war mir bis vor kurzem noch unbekannt. Wozu soll ich denn NodeJS über ein Python-Package installieren, wenn ich es auch selbst installieren kann?
Wenn Du die gleiche Frage im Kopf hast oder von “Batteries” noch nie gehört hast, lies weiter.
In diesem Artikel hab ich alles zusammengetragen, was das Batteries-Paket ist und wann Du es einsetzen solltest.
Hintergrund: Warum überhaupt NodeJS?
Anders als viele andere Libraries für Robot Framework ist die Browser Library kein reines Python-Paket.
Die Keywords der Library (z. B. Fill Text oder Click) sind in Python geschrieben; die eigentliche Steuerung des Browsers aber übernimmt Playwright — eine NodeJS-Bibliothek.
Zwischen beiden Welten läuft ein NodeJS-Prozess, den die Library über gRPC anspricht:
flowchart LR
RF["Robot Framework"] --> BL["Browser Library<br/>(Python)"]
BL -- "gRPC" --> NODE["NodeJS + Playwright"]
NODE --> BROWSER["Browser"]Das hat Folgen für die Umgebung: Um die Browser Library zu verwenden, benötigst Du eine NodeJS-Runtime und die dazugehörigen Pakete.
Zusammen mit den Browser-Binaries kommen dabei leicht über 700 MB zusammen.
Info: gRPC (Google Remote Procedure Call) ist ein Protokoll für Aufrufe zwischen Prozessen. Für Dich als Anwender bleibt das im Hintergrund. Über diesen Kanal wird quasi ein
Clickauf der Python-Seite zu einem Playwright-Aufruf auf der NodeJS-Seite “übersetzt”.
Auf einem Test-Host müssen also zwei Dinge liegen:
- eine NodeJS-Runtime
- die NodeJS-Pakete von Playwright
Wie Du beides bereitstellst, hängt davon ab, wie Du Deine Umgebung verwaltest.
Der Standardweg: pip und rfbrowser init
Möglichkeiten zum Erzeugen von virtuellen Python-Umgebungen gibt es viele: venv, virtualenv, conda oder uv.
Bei all diesen Varianten ist der Ablauf für die Browser Library bisher derselbe: NodeJS muss auf dem System liegen, und danach ruft man rfbrowser init auf.
npm kümmert sich dann um die Installation der Node.js-Pakete, sowie um die Installation der Browser.
Beispielhaft die manuelle Installation in einem venv:
pip install robotframework-browser
rfbrowser init chromium
Der Robotmk-Weg: RCC und conda.yaml
Bei Robotmk baut RCC die Laufzeitumgebung selbst zusammen, und zwar anhand einer Deklaration.
NodeJS wird dort nicht systemweit installiert, sondern ist Bestandteil des Environments, das in conda.yaml beschrieben wird:
dependencies:
- python=3.12
- pip=23.2.1
- nodejs>=26.13
- pip:
- robotframework>=7.5
- robotframework-browser>=21.0
rccPostInstall:
- rfbrowser init chromium
rfbrowser init holt auch hier danach die NodeJS-Pakete und die Browser.
Die neue Variante: Browser Batteries
Für jede Major-Version der Browser Library gibt es seit Version 19.9 ein passendes “Wheel”-Paket, das die NodeJS-Runtime und die Playwright-Pakete mitbringt.
Info: Ein “Wheel” ist ein Python-Paketformat, das die Installation von Paketen vereinfacht. Es enthält bereits kompilierte Dateien und Abhängigkeiten, sodass keine zusätzlichen Installationsschritte erforderlich sind.
Für den Standardweg heißt das: zwei Befehle, und NodeJS braucht auf dem System überhaupt nicht mehr vorhanden zu sein.
pip install robotframework-browser[bb]
rfbrowser install chromium
Für den Robotmk-Weg wandert das Extra in die conda.yaml:
dependencies:
- python=3.12
- pip=23.2.1
- pip:
- robotframework>=7.5
- robotframework-browser[bb]>=21.0
rccPostInstall:
- rfbrowser install chromium
Drei Dinge haben sich gegenüber der bisherigen Variante geändert:
robotframework-browser[bb]: Das Extra[bb]installiert den Python-Teil wie gehabt, zieht aber das passende Batteries-Wheel mit.rfbrowser install: Der Befehl heißt jetzt nicht mehrinit, sonderninstall. Hintergrund:initinstallierte die NodeJS-Abhängigkeiten und die Browser-Binaries;installmuss nur noch die Browser herunterladen, da die NodeJS-Seite ja schon vorliegt.- NodeJS als eigene Zutat entfällt. Im Standardweg brauchst Du es nicht mehr auf dem System; in der
conda.yamlmuss die Zeilenodejs=sogar raus. Lässt Du sie stehen, liegen zwei NodeJS-Runtimes im Environment, die sich gegenseitig in die Quere kommen. Batteries bringt die passende Version mit.
flowchart LR
subgraph VORHER["Bisher: NodeJS + rfbrowser init"]
direction TB
CF["NodeJS: nodejs.org<br/>oder conda-forge"] --> E1["Environment"]
PY1["PyPI: robotframework-browser"] --> E1
NPM["npm-Registry: ~85 Pakete"] -- "rfbrowser init" --> E1
CDN1["CDN: Browser-Binaries"] -- "rfbrowser init" --> E1
end
subgraph NACHHER["Mit Batteries: [bb]"]
direction TB
PY2["PyPI: robotframework-browser[bb]<br/>ein Wheel inkl. NodeJS + node_modules"] --> E2["Environment"]
CDN2["CDN: Browser-Binaries"] -- "rfbrowser install" --> E2
endDer Vergleich
Ich habe beide Varianten hinsichtlich der Installation und des Platzverbrauchs verglichen.
Platzverbrauch
NodeJS separat + rfbrowser init | [bb]-Wheel | |
|---|---|---|
| NodeJS-Runtime | 99,9 MB | 95,5 MB |
| npm + corepack | 12,0 MB (1.926 Dateien) | nicht enthalten |
node_modules | ~33,9 MB (~2.844 Dateien) | 33,9 MB (2.844 Dateien) |
| auf der Platte | ~146 MB, ~4.780 Dateien | 130,7 MB, 2.853 Dateien |
| Download | 34,5 MB + ~85 npm-Tarballs | 45,4 MB, ein Wheel |
(Gemessen am conda-forge-Paket nodejs 26.10.0 und am Batteries-Wheel 21.0.0, beide für Windows x64. Ein NodeJS von nodejs.org liegt in derselben Größenordnung.)
Die Ersparnis ist genau der npm-Fußabdruck: gerade mal 15 MB.
➡️ Der Platz ist also kein Argument, in keiner Richtung.
Installation
In der letzten Tabellenzeile stecken gleich mehrere Vorteile:
Weniger Dateien, weniger Downloads
- Ohne Batteries lädt der Host ein NodeJS-Paket und rund 85 Pakete aus der npm-Registry.
- Mit Batteries lädt er eine (1) Datei.
➡️ Das ist nicht nur schneller, sondern auch ein Ziel im Internet weniger, das u. U. freigeschaltet werden muss.
Proxy-Settings und TLS-Inspektion
Ich habe ja bereits im Artikel Proxy-Settings verstehen und anwenden beschrieben, wie viel Spaß man mit Proxies haben kann …
npm ist da noch mal eine eigene Disziplin: .npmrc, strict-ssl, cafile, NODE_EXTRA_CA_CERTS – und teilt davon nichts mit pip oder conda.
Im Batteries-Wheel dagegen liegt npm gar nicht mehr mit drin, weil es schlicht nicht gebraucht wird: Der Browser-Download läuft über den mitgelieferten Node, nicht über npx.
➡️ Einfacheres Setup, weniger Stolperfallen.
Garantierte NodeJS-Version
Schon öfter wurde ich von Kunden gefragt, welche NodeJS-Version denn nun die richtige sei.
Ich sage dann ganz offen: “Ich weiß es nicht”, weil ich glaube, dass es keine Rolle spielt.
Trotzdem hast Du mit “Batteries” die Gewissheit, dass die richtige NodeJS-Version verwendet wird.
➡️ Wegfall einer ganzen Fehlerkategorie
Daran solltest Du denken
Nichts davon ist geschenkt. Drei Punkte solltest Du vorher prüfen:
- Alte Plattformen fallen heraus: Die Wheels sind gebaut für glibc 2.28 (zu finden auf Debian 10, RHEL 8, Ubuntu 20.04), Windows 10 / Server 2016 und macOS 13.5. Darunter bekommst Du das Paket nicht zum Laufen.
- Versions-Gleichschritt: Das Batteries-Paket koppelt
robotframework-browserin exakt einer Version an eine NodeJS-Version. Eines allein hochzuziehen geht nicht. (Braucht man aber auch nicht wirklich – ich will es nur erwähnt haben.) - Die Verantwortung verschiebt sich von nodejs.org bzw. conda-forge zu PyPI und damit zum Package-Maintainer der Browser Library.
Was das für die Supply Chain bedeutet
Die folgenden Punkte sind nur relevant, wenn Du den Artikel RCC-Environments und die Supply Chain für bedeutsam hältst.
Vorher: Über die Datei package-lock.json mit exakten Versionen und Prüfsummen konnte die Lieferkette jederzeit aufs Paket genau geprüft werden.
Mit Batteries verschiebt sich die Lage:
- Positiv daran: Die NodeJS-Seite wird zu einem einzigen pip-versionierten Paket und landet damit im Freeze-File von RCC und in der Karenzzeitprüfung – wo der npm-Baum vorher nie auftauchte.
- Zu beachten: Statt 84 Prüfsummen, die npm einzeln gegen das Lockfile prüft, prüfst Du nur noch einen einzigen Wheel-Hash gegen PyPI. (Die Nachweisbarkeit bleibt allerdings erhalten, denn das Lockfile reist ja im Wheel mit.)
An den Browser-Binaries ändert Batteries nichts – die kommen weiterhin ohne Prüfsummenvergleich von einem CDN.
Fazit
Wir können also festhalten: Browser Batteries ist keine Platzoptimierung, sondern eher eine Installationsoptimierung. Es entfernt npm als dritten Paketmanager aus der Kette und damit den fragilsten Schritt bei der Installation der Browser Library.
Bei Robotmk ist das doppelt wichtig: dort läuft dieser Schritt nicht einmal, sondern auf jedem überwachten Host und bei jedem Neubau des Environments erneut.
Auf einem Entwicklungsrechner mit offenem Internetzugang wirst Du außer einer kürzeren Bauzeit kaum etwas merken.
In einem Unternehmensnetz mit Proxy, TLS-Inspektion und Virenscanner sieht das sicher wieder anders aus.
Wenn Du dazu Erfahrung oder eine Meinung hast, freue ich mich über einen Kommentar unter dem Artikel.
