"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.NonRecoverableDOMError = exports.FrameExecutionContext = exports.ElementHandle = void 0; exports.assertDone = assertDone; exports.isNonRecoverableDOMError = isNonRecoverableDOMError; exports.kUnableToAdoptErrorMessage = void 0; exports.throwElementIsNotAttached = throwElementIsNotAttached; exports.throwRetargetableDOMError = throwRetargetableDOMError; var _fs = _interopRequireDefault(require("fs")); var js = _interopRequireWildcard(require("./javascript")); var _progress = require("./progress"); var _utils = require("../utils"); var _fileUploadUtils = require("./fileUploadUtils"); var _protocolError = require("./protocolError"); var injectedScriptSource = _interopRequireWildcard(require("../generated/injectedScriptSource")); function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); } function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; } function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; } /** * 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. */ class NonRecoverableDOMError extends Error {} exports.NonRecoverableDOMError = NonRecoverableDOMError; function isNonRecoverableDOMError(error) { return error instanceof NonRecoverableDOMError; } class FrameExecutionContext extends js.ExecutionContext { constructor(delegate, frame, world) { super(frame, delegate, world || 'content-script'); this.frame = void 0; this._injectedScriptPromise = void 0; this.world = void 0; this.frame = frame; this.world = world; } adoptIfNeeded(handle) { if (handle instanceof ElementHandle && handle._context !== this) return this.frame._page._delegate.adoptElementHandle(handle, this); return null; } async evaluate(pageFunction, arg) { return js.evaluate(this, true /* returnByValue */, pageFunction, arg); } async evaluateHandle(pageFunction, arg) { return js.evaluate(this, false /* returnByValue */, pageFunction, arg); } async evaluateExpression(expression, options, arg) { return js.evaluateExpression(this, expression, { ...options, returnByValue: true }, arg); } async evaluateExpressionHandle(expression, options, arg) { return js.evaluateExpression(this, expression, { ...options, returnByValue: false }, arg); } injectedScript() { if (!this._injectedScriptPromise) { const custom = []; const selectorsRegistry = this.frame._page.context().selectors(); for (const [name, { source }] of selectorsRegistry._engines) custom.push(`{ name: '${name}', engine: (${source}) }`); const sdkLanguage = this.frame.attribution.playwright.options.sdkLanguage; const source = ` (() => { const module = {}; ${injectedScriptSource.source} return new (module.exports.InjectedScript())( globalThis, ${(0, _utils.isUnderTest)()}, "${sdkLanguage}", ${JSON.stringify(selectorsRegistry.testIdAttributeName())}, ${this.frame._page._delegate.rafCountForStablePosition()}, "${this.frame._page._browserContext._browser.options.name}", [${custom.join(',\n')}] ); })(); `; this._injectedScriptPromise = this.rawEvaluateHandle(source).then(handle => { handle._setPreview('InjectedScript'); return handle; }); } return this._injectedScriptPromise; } } exports.FrameExecutionContext = FrameExecutionContext; class ElementHandle extends js.JSHandle { constructor(context, objectId) { super(context, 'node', undefined, objectId); this.__elementhandle = true; this._page = void 0; this._frame = void 0; this._page = context.frame._page; this._frame = context.frame; this._initializePreview().catch(e => {}); } async _initializePreview() { const utility = await this._context.injectedScript(); this._setPreview(await utility.evaluate((injected, e) => 'JSHandle@' + injected.previewNode(e), this)); } asElement() { return this; } async evaluateInUtility(pageFunction, arg) { try { const utility = await this._frame._utilityContext(); return await utility.evaluate(pageFunction, [await utility.injectedScript(), this, arg]); } catch (e) { if (js.isJavaScriptErrorInEvaluate(e) || (0, _protocolError.isSessionClosedError)(e)) throw e; return 'error:notconnected'; } } async evaluateHandleInUtility(pageFunction, arg) { try { const utility = await this._frame._utilityContext(); return await utility.evaluateHandle(pageFunction, [await utility.injectedScript(), this, arg]); } catch (e) { if (js.isJavaScriptErrorInEvaluate(e) || (0, _protocolError.isSessionClosedError)(e)) throw e; return 'error:notconnected'; } } async ownerFrame() { const frameId = await this._page._delegate.getOwnerFrame(this); if (!frameId) return null; const frame = this._page._frameManager.frame(frameId); if (frame) return frame; for (const page of this._page._browserContext.pages()) { const frame = page._frameManager.frame(frameId); if (frame) return frame; } return null; } async isIframeElement() { return this.evaluateInUtility(([injected, node]) => node && (node.nodeName === 'IFRAME' || node.nodeName === 'FRAME'), {}); } async contentFrame() { const isFrameElement = throwRetargetableDOMError(await this.isIframeElement()); if (!isFrameElement) return null; return this._page._delegate.getContentFrame(this); } async generateLocatorString() { const selector = await this.evaluateInUtility(async ([injected, node]) => { return injected.generateSelectorSimple(node); }, {}); if (selector === 'error:notconnected') return; return (0, _utils.asLocator)('javascript', selector); } async getAttribute(metadata, name) { return this._frame.getAttribute(metadata, ':scope', name, {}, this); } async inputValue(metadata) { return this._frame.inputValue(metadata, ':scope', {}, this); } async textContent(metadata) { return this._frame.textContent(metadata, ':scope', {}, this); } async innerText(metadata) { return this._frame.innerText(metadata, ':scope', {}, this); } async innerHTML(metadata) { return this._frame.innerHTML(metadata, ':scope', {}, this); } async dispatchEvent(metadata, type, eventInit = {}) { return this._frame.dispatchEvent(metadata, ':scope', type, eventInit, {}, this); } async _scrollRectIntoViewIfNeeded(rect) { return await this._page._delegate.scrollRectIntoViewIfNeeded(this, rect); } async _waitAndScrollIntoViewIfNeeded(progress, waitForVisible) { const result = await this._retryAction(progress, 'scroll into view', async () => { progress.log(` waiting for element to be stable`); const waitResult = await this.evaluateInUtility(async ([injected, node, { waitForVisible }]) => { return await injected.checkElementStates(node, waitForVisible ? ['visible', 'stable'] : ['stable']); }, { waitForVisible }); if (waitResult) return waitResult; return await this._scrollRectIntoViewIfNeeded(); }, {}); assertDone(throwRetargetableDOMError(result)); } async scrollIntoViewIfNeeded(metadata, options = {}) { const controller = new _progress.ProgressController(metadata, this); return controller.run(progress => this._waitAndScrollIntoViewIfNeeded(progress, false /* waitForVisible */), this._page._timeoutSettings.timeout(options)); } async _clickablePoint() { const intersectQuadWithViewport = quad => { return quad.map(point => ({ x: Math.min(Math.max(point.x, 0), metrics.width), y: Math.min(Math.max(point.y, 0), metrics.height) })); }; const computeQuadArea = quad => { // Compute sum of all directed areas of adjacent triangles // https://en.wikipedia.org/wiki/Polygon#Simple_polygons let area = 0; for (let i = 0; i < quad.length; ++i) { const p1 = quad[i]; const p2 = quad[(i + 1) % quad.length]; area += (p1.x * p2.y - p2.x * p1.y) / 2; } return Math.abs(area); }; const [quads, metrics] = await Promise.all([this._page._delegate.getContentQuads(this), this._page.mainFrame()._utilityContext().then(utility => utility.evaluate(() => ({ width: innerWidth, height: innerHeight })))]); if (quads === 'error:notconnected') return quads; if (!quads || !quads.length) return 'error:notvisible'; // Allow 1x1 elements. Compensate for rounding errors by comparing with 0.99 instead. const filtered = quads.map(quad => intersectQuadWithViewport(quad)).filter(quad => computeQuadArea(quad) > 0.99); if (!filtered.length) return 'error:notinviewport'; if (this._page._browserContext._browser.options.name === 'firefox') { // Firefox internally uses integer coordinates, so 8.x is converted to 8 or 9 when clicking. // // This does not work nicely for small elements. For example, 1x1 square with corners // (8;8) and (9;9) is targeted when clicking at (8;8) but not when clicking at (9;9). // So, clicking at (8.x;8.y) will sometimes click at (9;9) and miss the target. // // Therefore, we try to find an integer point within a quad to make sure we click inside the element. for (const quad of filtered) { const integerPoint = findIntegerPointInsideQuad(quad); if (integerPoint) return integerPoint; } } // Return the middle point of the first quad. return quadMiddlePoint(filtered[0]); } async _offsetPoint(offset) { const [box, border] = await Promise.all([this.boundingBox(), this.evaluateInUtility(([injected, node]) => injected.getElementBorderWidth(node), {}).catch(e => {})]); if (!box || !border) return 'error:notvisible'; if (border === 'error:notconnected') return border; // Make point relative to the padding box to align with offsetX/offsetY. return { x: box.x + border.left + offset.x, y: box.y + border.top + offset.y }; } async _retryAction(progress, actionName, action, options) { let retry = 0; // We progressively wait longer between retries, up to 500ms. const waitTime = [0, 20, 100, 100, 500]; while (progress.isRunning()) { if (retry) { progress.log(`retrying ${actionName} action${options.trial ? ' (trial run)' : ''}`); const timeout = waitTime[Math.min(retry - 1, waitTime.length - 1)]; if (timeout) { progress.log(` waiting ${timeout}ms`); const result = await this.evaluateInUtility(([injected, node, timeout]) => new Promise(f => setTimeout(f, timeout)), timeout); if (result === 'error:notconnected') return result; } } else { progress.log(`attempting ${actionName} action${options.trial ? ' (trial run)' : ''}`); } if (!options.skipActionPreChecks && !options.force) await this._frame._page.performActionPreChecks(progress); const result = await action(retry); ++retry; if (result === 'error:notvisible') { if (options.force) throw new NonRecoverableDOMError('Element is not visible'); progress.log(' element is not visible'); continue; } if (result === 'error:notinviewport') { if (options.force) throw new NonRecoverableDOMError('Element is outside of the viewport'); progress.log(' element is outside of the viewport'); continue; } if (result === 'error:optionsnotfound') { progress.log(' did not find some options'); continue; } if (typeof result === 'object' && 'hitTargetDescription' in result) { progress.log(` ${result.hitTargetDescription} intercepts pointer events`); continue; } if (typeof result === 'object' && 'missingState' in result) { progress.log(` element is not ${result.missingState}`); continue; } return result; } return 'done'; } async _retryPointerAction(progress, actionName, waitForEnabled, action, options) { // Note: do not perform locator handlers checkpoint to avoid moving the mouse in the middle of a drag operation. const skipActionPreChecks = actionName === 'move and up'; return await this._retryAction(progress, actionName, async retry => { // By default, we scroll with protocol method to reveal the action point. // However, that might not work to scroll from under position:sticky elements // that overlay the target element. To fight this, we cycle through different // scroll alignments. This works in most scenarios. const scrollOptions = [undefined, { block: 'end', inline: 'end' }, { block: 'center', inline: 'center' }, { block: 'start', inline: 'start' }]; const forceScrollOptions = scrollOptions[retry % scrollOptions.length]; return await this._performPointerAction(progress, actionName, waitForEnabled, action, forceScrollOptions, options); }, { ...options, skipActionPreChecks }); } async _performPointerAction(progress, actionName, waitForEnabled, action, forceScrollOptions, options) { const { force = false, position } = options; const doScrollIntoView = async () => { if (forceScrollOptions) { return await this.evaluateInUtility(([injected, node, options]) => { if (node.nodeType === 1 /* Node.ELEMENT_NODE */) node.scrollIntoView(options); return 'done'; }, forceScrollOptions); } return await this._scrollRectIntoViewIfNeeded(position ? { x: position.x, y: position.y, width: 0, height: 0 } : undefined); }; if (this._frame.parentFrame()) { // Best-effort scroll to make sure any iframes containing this element are scrolled // into view and visible, so they are not throttled. // See https://github.com/microsoft/playwright/issues/27196 for an example. progress.throwIfAborted(); // Avoid action that has side-effects. await doScrollIntoView().catch(() => {}); } if (options.__testHookBeforeStable) await options.__testHookBeforeStable(); if (!force) { const elementStates = waitForEnabled ? ['visible', 'enabled', 'stable'] : ['visible', 'stable']; progress.log(` waiting for element to be ${waitForEnabled ? 'visible, enabled and stable' : 'visible and stable'}`); const result = await this.evaluateInUtility(async ([injected, node, { elementStates }]) => { return await injected.checkElementStates(node, elementStates); }, { elementStates }); if (result) return result; progress.log(` element is ${waitForEnabled ? 'visible, enabled and stable' : 'visible and stable'}`); } if (options.__testHookAfterStable) await options.__testHookAfterStable(); progress.log(' scrolling into view if needed'); progress.throwIfAborted(); // Avoid action that has side-effects. const scrolled = await doScrollIntoView(); if (scrolled !== 'done') return scrolled; progress.log(' done scrolling'); const maybePoint = position ? await this._offsetPoint(position) : await this._clickablePoint(); if (typeof maybePoint === 'string') return maybePoint; const point = roundPoint(maybePoint); progress.metadata.point = point; await this.instrumentation.onBeforeInputAction(this, progress.metadata); let hitTargetInterceptionHandle; if (force) { progress.log(` forcing action`); } else { if (options.__testHookBeforeHitTarget) await options.__testHookBeforeHitTarget(); const frameCheckResult = await this._checkFrameIsHitTarget(point); if (frameCheckResult === 'error:notconnected' || 'hitTargetDescription' in frameCheckResult) return frameCheckResult; const hitPoint = frameCheckResult.framePoint; const actionType = actionName === 'move and up' ? 'drag' : actionName === 'hover' || actionName === 'tap' ? actionName : 'mouse'; const handle = await this.evaluateHandleInUtility(([injected, node, { actionType, hitPoint, trial }]) => injected.setupHitTargetInterceptor(node, actionType, hitPoint, trial), { actionType, hitPoint, trial: !!options.trial }); if (handle === 'error:notconnected') return handle; if (!handle._objectId) { const error = handle.rawValue(); if (error === 'error:notconnected') return error; return { hitTargetDescription: error }; } hitTargetInterceptionHandle = handle; progress.cleanupWhenAborted(() => { // Do not await here, just in case the renderer is stuck (e.g. on alert) // and we won't be able to cleanup. hitTargetInterceptionHandle.evaluate(h => h.stop()).catch(e => {}); hitTargetInterceptionHandle.dispose(); }); } const actionResult = await this._page._frameManager.waitForSignalsCreatedBy(progress, options.waitAfter === true, async () => { if (options.__testHookBeforePointerAction) await options.__testHookBeforePointerAction(); progress.throwIfAborted(); // Avoid action that has side-effects. let restoreModifiers; if (options && options.modifiers) restoreModifiers = await this._page.keyboard.ensureModifiers(options.modifiers); progress.log(` performing ${actionName} action`); await action(point); if (restoreModifiers) await this._page.keyboard.ensureModifiers(restoreModifiers); if (hitTargetInterceptionHandle) { const stopHitTargetInterception = this._frame.raceAgainstEvaluationStallingEvents(() => { return hitTargetInterceptionHandle.evaluate(h => h.stop()); }).catch(e => 'done').finally(() => { var _hitTargetInterceptio; (_hitTargetInterceptio = hitTargetInterceptionHandle) === null || _hitTargetInterceptio === void 0 || _hitTargetInterceptio.dispose(); }); if (options.waitAfter !== false) { // When noWaitAfter is passed, we do not want to accidentally stall on // non-committed navigation blocking the evaluate. const hitTargetResult = await stopHitTargetInterception; if (hitTargetResult !== 'done') return hitTargetResult; } } progress.log(` ${options.trial ? 'trial ' : ''}${actionName} action done`); progress.log(' waiting for scheduled navigations to finish'); if (options.__testHookAfterPointerAction) await options.__testHookAfterPointerAction(); return 'done'; }); if (actionResult !== 'done') return actionResult; progress.log(' navigations have finished'); return 'done'; } async _markAsTargetElement(metadata) { if (!metadata.id) return; await this.evaluateInUtility(([injected, node, callId]) => { if (node.nodeType === 1 /* Node.ELEMENT_NODE */) injected.markTargetElements(new Set([node]), callId); }, metadata.id); } async hover(metadata, options) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._hover(progress, options); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } _hover(progress, options) { return this._retryPointerAction(progress, 'hover', false /* waitForEnabled */, point => this._page.mouse.move(point.x, point.y), { ...options, waitAfter: 'disabled' }); } async click(metadata, options = {}) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._click(progress, { ...options, waitAfter: !options.noWaitAfter }); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } _click(progress, options) { return this._retryPointerAction(progress, 'click', true /* waitForEnabled */, point => this._page.mouse.click(point.x, point.y, options), options); } async dblclick(metadata, options) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._dblclick(progress, options); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } _dblclick(progress, options) { return this._retryPointerAction(progress, 'dblclick', true /* waitForEnabled */, point => this._page.mouse.dblclick(point.x, point.y, options), { ...options, waitAfter: 'disabled' }); } async tap(metadata, options = {}) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._tap(progress, options); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } _tap(progress, options) { return this._retryPointerAction(progress, 'tap', true /* waitForEnabled */, point => this._page.touchscreen.tap(point.x, point.y), { ...options, waitAfter: 'disabled' }); } async selectOption(metadata, elements, values, options) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._selectOption(progress, elements, values, options); return throwRetargetableDOMError(result); }, this._page._timeoutSettings.timeout(options)); } async _selectOption(progress, elements, values, options) { let resultingOptions = []; await this._retryAction(progress, 'select option', async () => { await this.instrumentation.onBeforeInputAction(this, progress.metadata); if (!options.force) progress.log(` waiting for element to be visible and enabled`); const optionsToSelect = [...elements, ...values]; const result = await this.evaluateInUtility(async ([injected, node, { optionsToSelect, force }]) => { if (!force) { const checkResult = await injected.checkElementStates(node, ['visible', 'enabled']); if (checkResult) return checkResult; } return injected.selectOptions(node, optionsToSelect); }, { optionsToSelect, force: options.force }); if (Array.isArray(result)) { progress.log(' selected specified option(s)'); resultingOptions = result; return 'done'; } return result; }, options); return resultingOptions; } async fill(metadata, value, options = {}) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._fill(progress, value, options); assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } async _fill(progress, value, options) { progress.log(` fill("${value}")`); return await this._retryAction(progress, 'fill', async () => { await this.instrumentation.onBeforeInputAction(this, progress.metadata); if (!options.force) progress.log(' waiting for element to be visible, enabled and editable'); const result = await this.evaluateInUtility(async ([injected, node, { value, force }]) => { if (!force) { const checkResult = await injected.checkElementStates(node, ['visible', 'enabled', 'editable']); if (checkResult) return checkResult; } return injected.fill(node, value); }, { value, force: options.force }); progress.throwIfAborted(); // Avoid action that has side-effects. if (result === 'needsinput') { if (value) await this._page.keyboard.insertText(value);else await this._page.keyboard.press('Delete'); return 'done'; } else { return result; } }, options); } async selectText(metadata, options = {}) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { const result = await this._retryAction(progress, 'selectText', async () => { if (!options.force) progress.log(' waiting for element to be visible'); return await this.evaluateInUtility(async ([injected, node, { force }]) => { if (!force) { const checkResult = await injected.checkElementStates(node, ['visible']); if (checkResult) return checkResult; } return injected.selectText(node); }, { force: options.force }); }, options); assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } async setInputFiles(metadata, params) { const inputFileItems = await (0, _fileUploadUtils.prepareFilesForUpload)(this._frame, params); const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._setInputFiles(progress, inputFileItems); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(params)); } async _setInputFiles(progress, items) { const { filePayloads, localPaths, localDirectory } = items; const multiple = filePayloads && filePayloads.length > 1 || localPaths && localPaths.length > 1; const result = await this.evaluateHandleInUtility(([injected, node, { multiple, directoryUpload }]) => { const element = injected.retarget(node, 'follow-label'); if (!element) return; if (element.tagName !== 'INPUT') throw injected.createStacklessError('Node is not an HTMLInputElement'); const inputElement = element; if (multiple && !inputElement.multiple && !inputElement.webkitdirectory) throw injected.createStacklessError('Non-multiple file input can only accept single file'); if (directoryUpload && !inputElement.webkitdirectory) throw injected.createStacklessError('File input does not support directories, pass individual files instead'); if (!directoryUpload && inputElement.webkitdirectory) throw injected.createStacklessError('[webkitdirectory] input requires passing a path to a directory'); return inputElement; }, { multiple, directoryUpload: !!localDirectory }); if (result === 'error:notconnected' || !result.asElement()) return 'error:notconnected'; const retargeted = result.asElement(); await this.instrumentation.onBeforeInputAction(this, progress.metadata); progress.throwIfAborted(); // Avoid action that has side-effects. if (localPaths || localDirectory) { const localPathsOrDirectory = localDirectory ? [localDirectory] : localPaths; await Promise.all(localPathsOrDirectory.map(localPath => _fs.default.promises.access(localPath, _fs.default.constants.F_OK))); // Browsers traverse the given directory asynchronously and we want to ensure all files are uploaded. const waitForInputEvent = localDirectory ? this.evaluate(node => new Promise(fulfill => { node.addEventListener('input', fulfill, { once: true }); })).catch(() => {}) : Promise.resolve(); await this._page._delegate.setInputFilePaths(retargeted, localPathsOrDirectory); await waitForInputEvent; } else { await retargeted.evaluateInUtility(([injected, node, files]) => injected.setInputFiles(node, files), filePayloads); } return 'done'; } async focus(metadata) { const controller = new _progress.ProgressController(metadata, this); await controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._focus(progress); return assertDone(throwRetargetableDOMError(result)); }, 0); } async _focus(progress, resetSelectionIfNotFocused) { progress.throwIfAborted(); // Avoid action that has side-effects. return await this.evaluateInUtility(([injected, node, resetSelectionIfNotFocused]) => injected.focusNode(node, resetSelectionIfNotFocused), resetSelectionIfNotFocused); } async _blur(progress) { progress.throwIfAborted(); // Avoid action that has side-effects. return await this.evaluateInUtility(([injected, node]) => injected.blurNode(node), {}); } async type(metadata, text, options) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._type(progress, text, options); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } async _type(progress, text, options) { progress.log(`elementHandle.type("${text}")`); await this.instrumentation.onBeforeInputAction(this, progress.metadata); const result = await this._focus(progress, true /* resetSelectionIfNotFocused */); if (result !== 'done') return result; progress.throwIfAborted(); // Avoid action that has side-effects. await this._page.keyboard.type(text, options); return 'done'; } async press(metadata, key, options) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { await this._markAsTargetElement(metadata); const result = await this._press(progress, key, options); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } async _press(progress, key, options) { progress.log(`elementHandle.press("${key}")`); await this.instrumentation.onBeforeInputAction(this, progress.metadata); return this._page._frameManager.waitForSignalsCreatedBy(progress, !options.noWaitAfter, async () => { const result = await this._focus(progress, true /* resetSelectionIfNotFocused */); if (result !== 'done') return result; progress.throwIfAborted(); // Avoid action that has side-effects. await this._page.keyboard.press(key, options); return 'done'; }); } async check(metadata, options) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { const result = await this._setChecked(progress, true, options); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } async uncheck(metadata, options) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { const result = await this._setChecked(progress, false, options); return assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } async _setChecked(progress, state, options) { const isChecked = async () => { const result = await this.evaluateInUtility(([injected, node]) => injected.elementState(node, 'checked'), {}); if (result === 'error:notconnected' || result.received === 'error:notconnected') throwElementIsNotAttached(); return result.matches; }; await this._markAsTargetElement(progress.metadata); if ((await isChecked()) === state) return 'done'; const result = await this._click(progress, { ...options, waitAfter: 'disabled' }); if (result !== 'done') return result; if (options.trial) return 'done'; if ((await isChecked()) !== state) throw new NonRecoverableDOMError('Clicking the checkbox did not change its state'); return 'done'; } async boundingBox() { return this._page._delegate.getBoundingBox(this); } async ariaSnapshot(options) { return await this.evaluateInUtility(([injected, element, options]) => injected.ariaSnapshot(element, options), options); } async screenshot(metadata, options = {}) { const controller = new _progress.ProgressController(metadata, this); return controller.run(progress => this._page._screenshotter.screenshotElement(progress, this, options), this._page._timeoutSettings.timeout(options)); } async querySelector(selector, options) { return this._frame.selectors.query(selector, options, this); } async querySelectorAll(selector) { return this._frame.selectors.queryAll(selector, this); } async evalOnSelector(selector, strict, expression, isFunction, arg) { return this._frame.evalOnSelector(selector, strict, expression, isFunction, arg, this); } async evalOnSelectorAll(selector, expression, isFunction, arg) { return this._frame.evalOnSelectorAll(selector, expression, isFunction, arg, this); } async isVisible(metadata) { return this._frame.isVisible(metadata, ':scope', {}, this); } async isHidden(metadata) { return this._frame.isHidden(metadata, ':scope', {}, this); } async isEnabled(metadata) { return this._frame.isEnabled(metadata, ':scope', {}, this); } async isDisabled(metadata) { return this._frame.isDisabled(metadata, ':scope', {}, this); } async isEditable(metadata) { return this._frame.isEditable(metadata, ':scope', {}, this); } async isChecked(metadata) { return this._frame.isChecked(metadata, ':scope', {}, this); } async waitForElementState(metadata, state, options = {}) { const controller = new _progress.ProgressController(metadata, this); return controller.run(async progress => { const actionName = `wait for ${state}`; const result = await this._retryAction(progress, actionName, async () => { return await this.evaluateInUtility(async ([injected, node, state]) => { return (await injected.checkElementStates(node, [state])) || 'done'; }, state); }, {}); assertDone(throwRetargetableDOMError(result)); }, this._page._timeoutSettings.timeout(options)); } async waitForSelector(metadata, selector, options = {}) { return this._frame.waitForSelector(metadata, selector, options, this); } async _adoptTo(context) { if (this._context !== context) { const adopted = await this._page._delegate.adoptElementHandle(this, context); this.dispose(); return adopted; } return this; } async _checkFrameIsHitTarget(point) { let frame = this._frame; const data = []; while (frame.parentFrame()) { const frameElement = await frame.frameElement(); const box = await frameElement.boundingBox(); const style = await frameElement.evaluateInUtility(([injected, iframe]) => injected.describeIFrameStyle(iframe), {}).catch(e => 'error:notconnected'); if (!box || style === 'error:notconnected') return 'error:notconnected'; if (style === 'transformed') { // We cannot translate coordinates when iframe has any transform applied. // The best we can do right now is to skip the hitPoint check, // and solely rely on the event interceptor. return { framePoint: undefined }; } // Translate from viewport coordinates to frame coordinates. const pointInFrame = { x: point.x - box.x - style.left, y: point.y - box.y - style.top }; data.push({ frame, frameElement, pointInFrame }); frame = frame.parentFrame(); } // Add main frame. data.push({ frame, frameElement: null, pointInFrame: point }); for (let i = data.length - 1; i > 0; i--) { const element = data[i - 1].frameElement; const point = data[i].pointInFrame; // Hit target in the parent frame should hit the child frame element. const hitTargetResult = await element.evaluateInUtility(([injected, element, hitPoint]) => { return injected.expectHitTarget(hitPoint, element); }, point); if (hitTargetResult !== 'done') return hitTargetResult; } return { framePoint: data[0].pointInFrame }; } } exports.ElementHandle = ElementHandle; function throwRetargetableDOMError(result) { if (result === 'error:notconnected') throwElementIsNotAttached(); return result; } function throwElementIsNotAttached() { throw new Error('Element is not attached to the DOM'); } function assertDone(result) { // This function converts 'done' to void and ensures typescript catches unhandled errors. } function roundPoint(point) { return { x: (point.x * 100 | 0) / 100, y: (point.y * 100 | 0) / 100 }; } function quadMiddlePoint(quad) { const result = { x: 0, y: 0 }; for (const point of quad) { result.x += point.x / 4; result.y += point.y / 4; } return result; } function triangleArea(p1, p2, p3) { return Math.abs(p1.x * (p2.y - p3.y) + p2.x * (p3.y - p1.y) + p3.x * (p1.y - p2.y)) / 2; } function isPointInsideQuad(point, quad) { const area1 = triangleArea(point, quad[0], quad[1]) + triangleArea(point, quad[1], quad[2]) + triangleArea(point, quad[2], quad[3]) + triangleArea(point, quad[3], quad[0]); const area2 = triangleArea(quad[0], quad[1], quad[2]) + triangleArea(quad[1], quad[2], quad[3]); // Check that point is inside the quad. if (Math.abs(area1 - area2) > 0.1) return false; // Check that point is not on the right/bottom edge, because clicking // there does not actually click the element. return point.x < Math.max(quad[0].x, quad[1].x, quad[2].x, quad[3].x) && point.y < Math.max(quad[0].y, quad[1].y, quad[2].y, quad[3].y); } function findIntegerPointInsideQuad(quad) { // Try all four rounding directions of the middle point. const point = quadMiddlePoint(quad); point.x = Math.floor(point.x); point.y = Math.floor(point.y); if (isPointInsideQuad(point, quad)) return point; point.x += 1; if (isPointInsideQuad(point, quad)) return point; point.y += 1; if (isPointInsideQuad(point, quad)) return point; point.x -= 1; if (isPointInsideQuad(point, quad)) return point; } const kUnableToAdoptErrorMessage = exports.kUnableToAdoptErrorMessage = 'Unable to adopt element handle from a different document';