/** * 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 * as channels from '../protocol/channels'; import { ChannelOwner } from './channelOwner'; import { parseSerializedValue, serializeValue } from '../protocol/serializers'; import * as api from '../../types/types'; import * as structs from '../../types/structs'; export class JSHandle extends ChannelOwner implements api.JSHandle { private _preview: string; static from(handle: channels.JSHandleChannel): JSHandle { return (handle as any)._object; } constructor(parent: ChannelOwner, type: string, guid: string, initializer: channels.JSHandleInitializer) { super(parent, type, guid, initializer); this._preview = this._initializer.preview; this._channel.on('previewUpdated', ({ preview }) => this._preview = preview); } async evaluate(pageFunction: structs.PageFunctionOn, arg?: Arg): Promise { return this._wrapApiCall(async (channel: channels.JSHandleChannel) => { const result = await channel.evaluateExpression({ expression: String(pageFunction), isFunction: typeof pageFunction === 'function', arg: serializeArgument(arg) }); return parseResult(result.value); }); } async evaluateHandle(pageFunction: structs.PageFunctionOn, arg?: Arg): Promise> { return this._wrapApiCall(async (channel: channels.JSHandleChannel) => { const result = await channel.evaluateExpressionHandle({ expression: String(pageFunction), isFunction: typeof pageFunction === 'function', arg: serializeArgument(arg) }); return JSHandle.from(result.handle) as any as structs.SmartHandle; }); } async getProperty(propertyName: string): Promise { return this._wrapApiCall(async (channel: channels.JSHandleChannel) => { const result = await channel.getProperty({ name: propertyName }); return JSHandle.from(result.handle); }); } async getProperties(): Promise> { return this._wrapApiCall(async (channel: channels.JSHandleChannel) => { const map = new Map(); for (const { name, value } of (await channel.getPropertyList()).properties) map.set(name, JSHandle.from(value)); return map; }); } async jsonValue(): Promise { return this._wrapApiCall(async (channel: channels.JSHandleChannel) => { return parseResult((await channel.jsonValue()).value); }); } asElement(): T extends Node ? api.ElementHandle : null { return null as any; } async dispose() { return this._wrapApiCall(async (channel: channels.JSHandleChannel) => { return await channel.dispose(); }); } override toString(): string { return this._preview; } } // This function takes care of converting all JSHandles to their channels, // so that generic channel serializer converts them to guids. export function serializeArgument(arg: any): channels.SerializedArgument { const handles: channels.Channel[] = []; const pushHandle = (channel: channels.Channel): number => { handles.push(channel); return handles.length - 1; }; const value = serializeValue(arg, value => { if (value instanceof JSHandle) return { h: pushHandle(value._channel) }; return { fallThrough: value }; }, new Set()); return { value, handles }; } export function parseResult(value: channels.SerializedValue): any { return parseSerializedValue(value, undefined); } export function assertMaxArguments(count: number, max: number): asserts count { if (count > max) throw new Error('Too many arguments. If you need to pass more than 1 argument to the function wrap them in an object.'); }