/** * Copyright (c) Microsoft Corporation. * * Licensed under the Apache License, Version 2.0 (the 'License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import type { LaunchAndroidServerOptions } from './client/types'; import { ws } from './utilsBundle'; import type { WebSocketEventEmitter } from './utilsBundle'; import type { BrowserServer } from './client/browserType'; import { createGuid } from './utils'; import { createPlaywright } from './server/playwright'; import { PlaywrightServer } from './remote/playwrightServer'; export class AndroidServerLauncherImpl { async launchServer(options: LaunchAndroidServerOptions = {}): Promise { const playwright = createPlaywright('javascript'); // 1. Pre-connect to the device let devices = await playwright.android.devices({ host: options.adbHost, port: options.adbPort, omitDriverInstall: options.omitDriverInstall, }); if (devices.length === 0) throw new Error('No devices found'); if (options.deviceSerialNumber) { devices = devices.filter(d => d.serial === options.deviceSerialNumber); if (devices.length === 0) throw new Error(`No device with serial number '${options.deviceSerialNumber}' not found`); } if (devices.length > 1) throw new Error(`More than one device found. Please specify deviceSerialNumber`); const device = devices[0]; const path = options.wsPath ? (options.wsPath.startsWith('/') ? options.wsPath : `/${options.wsPath}`) : `/${createGuid()}`; // 2. Start the server const server = new PlaywrightServer({ path, maxConnections: 1, preLaunchedAndroidDevice: device }); const wsEndpoint = await server.listen(options.port); // 3. Return the BrowserServer interface const browserServer = new ws.EventEmitter() as (BrowserServer & WebSocketEventEmitter); browserServer.wsEndpoint = () => wsEndpoint; browserServer.close = () => device.close(); browserServer.kill = () => device.close(); device.on('close', () => { server.close(); browserServer.emit('close'); }); return browserServer; } }