跳到主要内容

评估 JavaScript

简介

Playwright 脚本在您的 Playwright 环境中运行。您的页面脚本在浏览器页面环境中运行。这些环境互不交叉,它们运行在不同的进程、不同的虚拟机中,甚至可能在不同的计算机上。

Page.EvaluateAsync() API 可以在网页上下文中运行 JavaScript 函数,并将结果带回 Playwright 环境。在 `evaluate` 中可以使用 `window` 和 `document` 等浏览器全局对象。

var href = await page.EvaluateAsync<string>("document.location.href");

如果结果是 Promise 或者函数是异步的,evaluate 将自动等待其解析完成。

int status = await page.EvaluateAsync<int>(@"async () => {
const response = await fetch(location.href);
return response.status;
}");

不同环境

评估的脚本在浏览器环境中运行,而您的测试在测试环境中运行。这意味着您不能直接在页面中使用测试中的变量,反之亦然。相反,您应该将它们作为参数显式传递。

以下代码片段是错误的,因为它直接使用了变量

var data = "some data";
var result = await page.EvaluateAsync(@"() => {
// WRONG: there is no 'data' in the web page.
window.myApp.use(data);
}");

以下代码片段是正确的,因为它将值显式作为参数传递

var data = "some data";
// Pass |data| as a parameter.
var result = await page.EvaluateAsync("data => { window.myApp.use(data); }", data);

评估参数

Playwright 的评估方法,如 Page.EvaluateAsync(),接受一个可选的参数。该参数可以是 可序列化的值和 JSHandle 实例的混合。句柄会自动转换为它们所代表的值。

// A primitive value.
await page.EvaluateAsync<int>("num => num", 42);

// An array.
await page.EvaluateAsync<int[]>("array => array.length", new[] { 1, 2, 3 });

// An object.
await page.EvaluateAsync<object>("object => object.foo", new { foo = "bar" });

// A single handle.
var button = await page.EvaluateHandleAsync("window.button");
await page.EvaluateAsync<IJSHandle>("button => button.textContent", button);

// Alternative notation using JSHandle.EvaluateAsync.
await button.EvaluateAsync<string>("(button, from) => button.textContent.substring(from)", 5);

// Object with multiple handles.
var button1 = await page.EvaluateHandleAsync("window.button1");
var button2 = await page.EvaluateHandleAsync("window.button2");
await page.EvaluateAsync("o => o.button1.textContent + o.button2.textContent", new { button1, button2 });

// Object destructuring works. Note that property names must match
// between the destructured object and the argument.
// Also note the required parenthesis.
await page.EvaluateAsync("({ button1, button2 }) => button1.textContent + button2.textContent", new { button1, button2 });

// Array works as well. Arbitrary names can be used for destructuring.
// Note the required parenthesis.
await page.EvaluateAsync("([b1, b2]) => b1.textContent + b2.textContent", new[] { button1, button2 });

// Any mix of serializables and handles works.
await page.EvaluateAsync("x => x.button1.textContent + x.list[0].textContent + String(x.foo)", new { button1, list = new[] { button2 }, foo = null as object });

初始化脚本

有时,在页面开始加载之前评估一些内容会很方便。例如,您可能想要设置一些模拟数据或测试数据。

在这种情况下,使用 Page.AddInitScriptAsync()BrowserContext.AddInitScriptAsync()。在下面的示例中,我们将用一个常量值替换 `Math.random()`。

首先,创建一个包含模拟脚本的 `preload.js` 文件。

// preload.js
Math.random = () => 42;

接下来,向页面添加初始化脚本。

// In your test, assuming the "preload.js" file is in the "mocks" directory.
await Page.AddInitScriptAsync(scriptPath: "mocks/preload.js");