Configuration et configuration de l'ApiServer

L'intégration de Playwright dans Mbbrowser prend en charge trois langages. Vous pouvez choisir celui qui correspond le mieux à l'expertise de votre équipe. Les étapes d'installation varient légèrement pour chacun ; veuillez lire la section correspondante.

---

Choisissez votre langage

TIP

• JavaScript (Node.js) : Similaire à Puppeteer ; scripts concis. Recommandé pour les développeurs frontend.
• Python : Idéal pour l'analyse de données ou le scraping Web ; Mbbrowser gère l'environnement virtuel pour vous.
• Java : Intégration transparente pour les projets d'entreprise ou les équipes utilisant déjà une pile Java.

---

1. Environnement JavaScript / TypeScript

1. Installer Node.js

Téléchargez la version LTS (par exemple, Node.js 20.x) sur le site officiel de Node.js.

Vérifiez l'installation :

node -v   # Devrait afficher v20.x.x ou plus
npm -v

2. Créer le projet et installer Playwright

# Créer le dossier du projet
mkdir mb-playwright && cd mb-playwright

# Initialiser le projet npm
npm init -y

# Installer Playwright (Bibliothèque de base uniquement ; pas besoin des navigateurs intégrés, nous utilisons Mbbrowser)
npm install playwright

NOTE

Pendant l'installation, Playwright peut tenter de télécharger des fichiers de navigateur. Comme nous utilisons le navigateur de Mbbrowser, vous pouvez ignorer cette étape en définissant une variable d'environnement :

set PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
npm install playwright

3. Installer axios (Pour appeler l'ApiServer de Mbbrowser)

npm install axios

---

2. Environnement Python

1. Installer Python

Téléchargez Python 3.8+ sur le site officiel de Python.

Assurez-vous de cocher : ✅ Add Python to PATH pendant l'installation.

2. Environnement virtuel Playwright Python de Mbbrowser

IMPORTANT

Mbbrowser contient un environnement virtuel indépendant intégré pour Playwright Python situé dans le sous-répertoire python\Playwright\ de votre chemin d'installation Mbbrowser.

Lors de l'exécution via le gestionnaire de scripts du client Mbbrowser, Mbbrowser active automatiquement cet environnement virtuel.

Si vous souhaitez déboguer indépendamment via la ligne de commande, une activation manuelle est requise :

# Naviguer vers le répertoire python dans le chemin d'installation de Mbbrowser
cd "C:\Program Files (x86)\Mbbrowser_vX.X.X\python"
# Activer l'environnement virtuel
Playwright\Scripts\activate
# Vous pouvez maintenant utiliser pip ou exécuter des commandes playwright normalement

3. Installer la bibliothèque Playwright Python

Une fois l'environnement virtuel activé :

pip install playwright requests

NOTE

playwright installera les dépendances nécessaires mais vous n'avez pas besoin d'exécuter playwright install pour télécharger les navigateurs.

---

3. Environnement Java

1. Installer le JDK

Téléchargez le JDK 11 ou 17 (17 LTS recommandé) sur Adoptium.

2. Pilote Playwright Java de Mbbrowser

IMPORTANT

Mbbrowser regroupe les fichiers JAR nécessaires pour Playwright Java dans son répertoire d'installation :

Chemin_Installation_Mbbrowser\
└── lib\
    ├── playwright-1.48.0.jar
    ├── driver-bundle-1.48.0.jar
    └── gson-2.x.jar

L'exécution des scripts Java via le gestionnaire de scripts Mbbrowser extrait automatiquement le driver-bundle et configure l'environnement.

3. Dépendance Maven / Gradle

Si vous utilisez Maven :

<dependency>
  <groupId>com.microsoft.playwright</groupId>
  <artifactId>playwright</artifactId>
  <version>1.50.0</version>
</dependency>

---

4. Activer l'ApiServer de Mbbrowser (Tous les langages)

IMPORTANT

Quel que soit le langage choisi, vous devez démarrer l'ApiServer avant que votre script puisse communiquer avec Mbbrowser !

Obtenir les informations d'authentification de l'application

1. Ouvrez le client Mbbrowser et connectez-vous.
2. Allez dans Centre personnel → Paramètres API.
3. Obtenez (ou générez) votre APP_ID and APP_KEY.

Démarrer l'ApiServer

Ouvrez CMD avec les privilèges d'administrateur et naviguez vers le répertoire d'installation de Mbbrowser :

apiserver.exe --port=8186 --app_id=VOTRE_APP_ID --app_key=VOTRE_APP_KEY --hide=off

Paramètre	Description	Valeur recommandée
--port	Port d'écoute	8186 (Par défaut)
--app_id	ID d'authentification	Depuis le centre personnel
--app_key	Clé d'authentification	Depuis le centre personnel
--hide	Masquer le navigateur ?	off (visible est préférable pour le débogage)

En cas de succès :

ApiServer started at http://127.0.0.1:8186

---

5. Obtenir le Session_ID de l'environnement

Dans le panneau principal de Mbbrowser, trouvez votre environnement cible :

• Clic droit → Copier l'ID de l'environnement (Session_ID).
• Format : chaîne hexadécimale de 32 caractères (ex : 373808cb37bd63f5f7d92415e736e85f).

---

6. Comprendre la réponse de l'ApiServer (champ ws)

Lors de l'appel à /api/v1/browser/start, la structure des données renvoyées ressemble à ceci :

{
  "code": 0,
  "message": "success",
  "data": {
    "http": "127.0.0.1:9222",
    "ws": "ws://127.0.0.1:9222/devtools/browser/VOTRE-ID-NAVIGATEUR"
  }
}

Champ	Signification	Utilisation dans Playwright
data.http	Adresse de débogage HTTP	Principalement pour Selenium.
data.ws	Adresse WebSocket CDP	Crucial pour Playwright ✅

---

7. Liste de contrôle de configuration

Avant de passer au chapitre suivant, assurez-vous que :

• [ ] L'environnement d'exécution du langage (JS/Python/Java) est installé.
• [ ] La bibliothèque playwright est installée.
• [ ] L'ApiServer est en cours d'exécution et http://127.0.0.1:8186/ est accessible.
• [ ] Vous avez le Session_ID de votre environnement cible.
• [ ] Vous comprenez que data.ws est l'adresse WebSocket nécessaire pour Playwright.

---

TIP

Prêt ? Le prochain chapitre Démarrage rapide : Connexion fournit des scripts complets et exécutables pour les trois langages.