/** * 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 { BrowserWindow } from 'electron'; import * as structs from '../../types/structs'; import * as api from '../../types/types'; import * as channels from '../protocol/channels'; import { TimeoutSettings } from '../utils/timeoutSettings'; import { headersObjectToArray } from '../utils/utils'; import { BrowserContext } from './browserContext'; import { ChannelOwner } from './channelOwner'; import { envObjectToArray } from './clientHelper'; import { Events } from './events'; import { JSHandle, parseResult, serializeArgument } from './jsHandle'; import { Page } from './page'; import { Env, WaitForEventOptions, Headers } from './types'; import { Waiter } from './waiter'; type ElectronOptions = Omit & { env?: Env, extraHTTPHeaders?: Headers, }; type ElectronAppType = typeof import('electron'); export class Electron extends ChannelOwner implements api.Electron { static from(electron: channels.ElectronChannel): Electron { return (electron as any)._object; } constructor(parent: ChannelOwner, type: string, guid: string, initializer: channels.ElectronInitializer) { super(parent, type, guid, initializer); } async launch(options: ElectronOptions = {}): Promise { const params: channels.ElectronLaunchParams = { ...options, extraHTTPHeaders: options.extraHTTPHeaders && headersObjectToArray(options.extraHTTPHeaders), env: envObjectToArray(options.env ? options.env : process.env), }; const app = ElectronApplication.from((await this._channel.launch(params)).electronApplication); app._context._options = params; return app; } } export class ElectronApplication extends ChannelOwner implements api.ElectronApplication { readonly _context: BrowserContext; private _windows = new Set(); private _timeoutSettings = new TimeoutSettings(); static from(electronApplication: channels.ElectronApplicationChannel): ElectronApplication { return (electronApplication as any)._object; } constructor(parent: ChannelOwner, type: string, guid: string, initializer: channels.ElectronApplicationInitializer) { super(parent, type, guid, initializer); this._context = BrowserContext.from(initializer.context); for (const page of this._context._pages) this._onPage(page); this._context.on(Events.BrowserContext.Page, page => this._onPage(page)); this._channel.on('close', () => this.emit(Events.ElectronApplication.Close)); } _onPage(page: Page) { this._windows.add(page); this.emit(Events.ElectronApplication.Window, page); page.once(Events.Page.Close, () => this._windows.delete(page)); } windows(): Page[] { // TODO: add ElectronPage class inherting from Page. return [...this._windows]; } async firstWindow(): Promise { if (this._windows.size) return this._windows.values().next().value; return this.waitForEvent('window'); } context(): BrowserContext { return this._context; } async close() { await this._channel.close(); } async waitForEvent(event: string, optionsOrPredicate: WaitForEventOptions = {}): Promise { return this._wrapApiCall(async () => { const timeout = this._timeoutSettings.timeout(typeof optionsOrPredicate === 'function' ? {} : optionsOrPredicate); const predicate = typeof optionsOrPredicate === 'function' ? optionsOrPredicate : optionsOrPredicate.predicate; const waiter = Waiter.createForEvent(this, event); waiter.rejectOnTimeout(timeout, `Timeout ${timeout}ms exceeded while waiting for event "${event}"`); if (event !== Events.ElectronApplication.Close) waiter.rejectOnEvent(this, Events.ElectronApplication.Close, new Error('Electron application closed')); const result = await waiter.waitForEvent(this, event, predicate as any); waiter.dispose(); return result; }); } async browserWindow(page: Page): Promise> { const result = await this._channel.browserWindow({ page: page._channel }); return JSHandle.from(result.handle); } async evaluate(pageFunction: structs.PageFunctionOn, arg: Arg): Promise { const result = await this._channel.evaluateExpression({ expression: String(pageFunction), isFunction: typeof pageFunction === 'function', arg: serializeArgument(arg) }); return parseResult(result.value); } async evaluateHandle(pageFunction: structs.PageFunctionOn, arg: Arg): Promise> { const result = await this._channel.evaluateExpressionHandle({ expression: String(pageFunction), isFunction: typeof pageFunction === 'function', arg: serializeArgument(arg) }); return JSHandle.from(result.handle) as any as structs.SmartHandle; } }