Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
docs: evaluate/evaluateHandle handle examples (#41002)
Simon Knott23a55b2ce133
diff --git a/docs/src/api/class-frame.md b/docs/src/api/class-frame.mdindex b553b7180c..c73aa88e7b 100644--- a/docs/src/api/class-frame.md+++ b/docs/src/api/class-frame.md@@ -680,7 +680,7 @@ Console.WriteLine(await frame.EvaluateAsync<int>("1 + 2")); // prints "3"[ElementHandle] instances can be passed as an argument to the [`method: Frame.evaluate`]:```js-const bodyHandle = await frame.evaluate('document.body');+const bodyHandle = await frame.evaluateHandle('document.body');const html = await frame.evaluate(([body, suffix]) =>body.innerHTML + suffix, [bodyHandle, 'hello'],);@@ -688,25 +688,25 @@ await bodyHandle.dispose();``````java-ElementHandle bodyHandle = frame.evaluate("document.body");+ElementHandle bodyHandle = frame.evaluateHandle("document.body");String html = (String) frame.evaluate("([body, suffix]) => body.innerHTML + suffix", Arrays.asList(bodyHandle, "hello"));bodyHandle.dispose();``````python async-body_handle = await frame.evaluate("document.body")+body_handle = await frame.evaluate_handle("document.body")html = await frame.evaluate("([body, suffix]) => body.innerHTML + suffix", [body_handle, "hello"])await body_handle.dispose()``````python sync-body_handle = frame.evaluate("document.body")+body_handle = frame.evaluate_handle("document.body")html = frame.evaluate("([body, suffix]) => body.innerHTML + suffix", [body_handle, "hello"])body_handle.dispose()``````csharp-var bodyHandle = await frame.EvaluateAsync("document.body");+var bodyHandle = await frame.EvaluateHandleAsync("document.body");var html = await frame.EvaluateAsync<string>("([body, suffix]) => body.innerHTML + suffix", new object [] { bodyHandle, "hello" });await bodyHandle.DisposeAsync();```@@ -773,11 +773,11 @@ JSHandle aHandle = frame.evaluateHandle("document"); // Handle for the "document``````python async-a_handle = await page.evaluate_handle("document") # handle for the "document"+a_handle = await frame.evaluate_handle("document") # handle for the "document"``````python sync-a_handle = page.evaluate_handle("document") # handle for the "document"+a_handle = frame.evaluate_handle("document") # handle for the "document"``````csharp@@ -803,15 +803,15 @@ resultHandle.dispose();``````python async-a_handle = await page.evaluate_handle("document.body")-result_handle = await page.evaluate_handle("body => body.innerHTML", a_handle)+a_handle = await frame.evaluate_handle("document.body")+result_handle = await frame.evaluate_handle("body => body.innerHTML", a_handle)print(await result_handle.json_value())await result_handle.dispose()``````python sync-a_handle = page.evaluate_handle("document.body")-result_handle = page.evaluate_handle("body => body.innerHTML", a_handle)+a_handle = frame.evaluate_handle("document.body")+result_handle = frame.evaluate_handle("body => body.innerHTML", a_handle)print(result_handle.json_value())result_handle.dispose()```diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.mdindex ad2778b81b..606bab5d35 100644--- a/docs/src/api/class-page.md+++ b/docs/src/api/class-page.md@@ -1522,7 +1522,7 @@ Console.WriteLine(await page.EvaluateAsync<int>("1 + 2")); // prints "3"[ElementHandle] instances can be passed as an argument to the [`method: Page.evaluate`]:```js-const bodyHandle = await page.evaluate('document.body');+const bodyHandle = await page.evaluateHandle('document.body');const html = await page.evaluate<string, HTMLElement>(([body, suffix]) =>body.innerHTML + suffix, [bodyHandle, 'hello']);@@ -1530,25 +1530,25 @@ await bodyHandle.dispose();``````java-ElementHandle bodyHandle = page.evaluate("document.body");+ElementHandle bodyHandle = page.evaluateHandle("document.body");String html = (String) page.evaluate("([body, suffix]) => body.innerHTML + suffix", Arrays.asList(bodyHandle, "hello"));bodyHandle.dispose();``````python async-body_handle = await page.evaluate("document.body")+body_handle = await page.evaluate_handle("document.body")html = await page.evaluate("([body, suffix]) => body.innerHTML + suffix", [body_handle, "hello"])await body_handle.dispose()``````python sync-body_handle = page.evaluate("document.body")+body_handle = page.evaluate_handle("document.body")html = page.evaluate("([body, suffix]) => body.innerHTML + suffix", [body_handle, "hello"])body_handle.dispose()``````csharp-var bodyHandle = await page.EvaluateAsync("document.body");+var bodyHandle = await page.EvaluateHandleAsync("document.body");var html = await page.EvaluateAsync<string>("([body, suffix]) => body.innerHTML + suffix", new object [] { bodyHandle, "hello" });await bodyHandle.DisposeAsync();```diff --git a/packages/playwright-client/types/types.d.ts b/packages/playwright-client/types/types.d.tsindex 078af1bdae..d15884b399 100644--- a/packages/playwright-client/types/types.d.ts+++ b/packages/playwright-client/types/types.d.ts@@ -121,7 +121,7 @@ export interface Page {* [page.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-page#page-evaluate):** ```js- * const bodyHandle = await page.evaluate('document.body');+ * const bodyHandle = await page.evaluateHandle('document.body');* const html = await page.evaluate<string, HTMLElement>(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello']* );@@ -172,7 +172,7 @@ export interface Page {* [page.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-page#page-evaluate):** ```js- * const bodyHandle = await page.evaluate('document.body');+ * const bodyHandle = await page.evaluateHandle('document.body');* const html = await page.evaluate<string, HTMLElement>(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello']* );@@ -5372,7 +5372,7 @@ export interface Frame {* [frame.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-evaluate):** ```js- * const bodyHandle = await frame.evaluate('document.body');+ * const bodyHandle = await frame.evaluateHandle('document.body');* const html = await frame.evaluate(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello'],* );@@ -5419,7 +5419,7 @@ export interface Frame {* [frame.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-evaluate):** ```js- * const bodyHandle = await frame.evaluate('document.body');+ * const bodyHandle = await frame.evaluateHandle('document.body');* const html = await frame.evaluate(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello'],* );diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.tsindex 078af1bdae..d15884b399 100644--- a/packages/playwright-core/types/types.d.ts+++ b/packages/playwright-core/types/types.d.ts@@ -121,7 +121,7 @@ export interface Page {* [page.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-page#page-evaluate):** ```js- * const bodyHandle = await page.evaluate('document.body');+ * const bodyHandle = await page.evaluateHandle('document.body');* const html = await page.evaluate<string, HTMLElement>(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello']* );@@ -172,7 +172,7 @@ export interface Page {* [page.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-page#page-evaluate):** ```js- * const bodyHandle = await page.evaluate('document.body');+ * const bodyHandle = await page.evaluateHandle('document.body');* const html = await page.evaluate<string, HTMLElement>(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello']* );@@ -5372,7 +5372,7 @@ export interface Frame {* [frame.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-evaluate):** ```js- * const bodyHandle = await frame.evaluate('document.body');+ * const bodyHandle = await frame.evaluateHandle('document.body');* const html = await frame.evaluate(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello'],* );@@ -5419,7 +5419,7 @@ export interface Frame {* [frame.evaluate(pageFunction[, arg])](https://playwright.dev/docs/api/class-frame#frame-evaluate):** ```js- * const bodyHandle = await frame.evaluate('document.body');+ * const bodyHandle = await frame.evaluateHandle('document.body');* const html = await frame.evaluate(([body, suffix]) =>* body.innerHTML + suffix, [bodyHandle, 'hello'],* );