Browser Batteries: NodeJS im Gepäck

Das 'Batteries-included'-Paket der Browser Library unter der Lupe

Browser Batteries: NodeJS im Gepäck
Inhaltsverzeichnis

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 Click auf der Python-Seite zu einem Playwright-Aufruf auf der NodeJS-Seite “übersetzt”.

Auf einem Test-Host müssen also zwei Dinge liegen:

  1. eine NodeJS-Runtime
  2. 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 mehr init, sondern install. Hintergrund: init installierte die NodeJS-Abhängigkeiten und die Browser-Binaries; install muss 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.yaml muss die Zeile nodejs= 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
    end

Der Vergleich

Ich habe beide Varianten hinsichtlich der Installation und des Platzverbrauchs verglichen.

Platzverbrauch

NodeJS separat + rfbrowser init[bb]-Wheel
NodeJS-Runtime99,9 MB95,5 MB
npm + corepack12,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 Dateien130,7 MB, 2.853 Dateien
Download34,5 MB + ~85 npm-Tarballs45,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-browser in 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.



Simon Meggle avatar
Über den Autor
Simon Meggle ist Erfinder des Robotmk-Projekts und Gründer der ELABIT GmbH.
Er hat sich auf die Integration von Robot Framework-Tests in Checkmk-Umgebungen spezialisiert. In seinen über 20 Jahren Berufserfahrung als Administrator und Consultant war Monitoring immer sein Steckenpferd.
Inzwischen arbeitet Simon als Teilzeit-Produktmanager bei Checkmk, um Robotmk noch tiefer in Checkmk zu integrieren.
Für Synthetic Monitoring mit Robotmk bietet er vertiefende Online-Kurse und Workshops an und unterstützt Kunden bei der Implementierung.
Auf https://blog.robotmk.org berichtet er über die neuesten Entwicklungen bei Robotmk und Robot Framework, verfasst Tutorials und verrät der Community seine Best Practices.