From dfdb862386e2b1df9daa1b123e20ebfdcbb2e349 Mon Sep 17 00:00:00 2001 From: sipayrt Date: Thu, 7 Nov 2024 11:26:12 +0300 Subject: [PATCH] fix(commands): fix addCommand and overwriteCommand examples --- docs/commands/browser/addCommand.mdx | 43 +++++++++++++------ docs/commands/browser/overwriteCommand.mdx | 38 +++++++++++----- .../current/commands/browser/addCommand.mdx | 43 +++++++++++++------ .../commands/browser/overwriteCommand.mdx | 37 +++++++++++----- 4 files changed, 111 insertions(+), 50 deletions(-) diff --git a/docs/commands/browser/addCommand.mdx b/docs/commands/browser/addCommand.mdx index 3e69e17..b0682d2 100644 --- a/docs/commands/browser/addCommand.mdx +++ b/docs/commands/browser/addCommand.mdx @@ -14,28 +14,43 @@ Use the `addCommand` command to add your own command to the browser or to an ele ## Usage {#usage} ```javascript -await browser.addCommand(name, callback, elementScope); +browser.addCommand(name, callback, elementScope); ``` ## Command Parameters {#parameters} - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + +
**Name****Type****Description**
nameStringCustom command name.
callbackFunctionCommand implementation function.
elementScopeBooleanIf the value is _true_, add the command to the element instead of the browser. Default: _false_.
**Name****Type****Description**
nameStringCustom command name.
callbackFunctionCommand implementation function.
elementScopeBooleanIf the value is _true_, add the command to the element instead of the browser. Default: _false_.
## Usage Examples {#examples} ```javascript // add the getUrlAndTitle command -await browser.addCommand("getUrlAndTitle", async function (customParam) { +browser.addCommand("getUrlAndTitle", async function (customParam) { return { url: await this.getUrl(), // `this` here and below refers to the "browser" object title: await this.getTitle(), @@ -45,14 +60,14 @@ await browser.addCommand("getUrlAndTitle", async function (customParam) { // use the new getUrlAndTitle command it("should use my add command", async ({ browser }) => { - await browser.url("https://webdriver.io"); + await browser.url("https://testplane.io"); const result = await browser.getUrlAndTitle("foobar"); - assert.strictEqual(result.url, "https://webdriver.io"); + assert.strictEqual(result.url, "https://testplane.io"); assert.strictEqual( result.title, - "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js", + "Testplane Docs | Testplane Docs", ); assert.strictEqual(result.customParam, "foobar"); }); diff --git a/docs/commands/browser/overwriteCommand.mdx b/docs/commands/browser/overwriteCommand.mdx index 4ee162f..a17a070 100644 --- a/docs/commands/browser/overwriteCommand.mdx +++ b/docs/commands/browser/overwriteCommand.mdx @@ -19,25 +19,41 @@ await browser.overwriteCommand(name, callback, elementScope); ## Command Parameters {#parameters} - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + +
**Name****Type****Description**
nameStringThe name of the custom command.
callbackFunctionThe function implementation of the command.
elementScopeBooleanIf the value is _true_, add the command to the element instead of the browser. Default: _false_.
**Name****Type****Description**
nameStringThe name of the custom command.
callbackFunctionThe function implementation of the command.
elementScopeBooleanIf the value is _true_, add the command to the element instead of the browser. Default: _false_.
## Usage Examples {#examples} ```javascript // log the pause duration in ms before the pause and then return the value -await browser.overwriteCommand("pause", function (origPauseFunction, ms) { +await browser.overwriteCommand("pause", async function (origPauseFunction, ms) { console.log(`Sleeping for ${ms}`); - origPauseFunction(ms); + await origPauseFunction(ms); return ms; }); diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/addCommand.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/addCommand.mdx index cf181f8..9e5c955 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/addCommand.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/addCommand.mdx @@ -14,28 +14,43 @@ import Admonition from "@theme/Admonition"; ## Использование {#usage} ```javascript -await browser.addCommand(name, callback, elementScope); +browser.addCommand(name, callback, elementScope); ``` ## Параметры команды {#parameters} - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + +
**Имя****Тип****Описание**
nameStringИмя кастомной команды.
callbackFunctionФункция-реализация команды.
elementScopeBooleanЕсли значение _true_, то добавить команду к элементу, а не к браузеру. По умолчанию: _false_.
**Имя****Тип****Описание**
nameStringИмя кастомной команды.
callbackFunctionФункция-реализация команды.
elementScopeBooleanЕсли значение _true_, то добавить команду к элементу, а не к браузеру. По умолчанию: _false_.
## Примеры использования {#examples} ```javascript // добавляем команду getUrlAndTitle -await browser.addCommand("getUrlAndTitle", async function (customParam) { +browser.addCommand("getUrlAndTitle", async function (customParam) { return { url: await this.getUrl(), // `this` здесь и ниже относится к объекту "browser" title: await this.getTitle(), @@ -45,14 +60,14 @@ await browser.addCommand("getUrlAndTitle", async function (customParam) { // используем новую команду getUrlAndTitle it("should use my add command", async ({ browser }) => { - await browser.url("https://webdriver.io"); + await browser.url("https://testplane.io"); const result = await browser.getUrlAndTitle("foobar"); - assert.strictEqual(result.url, "https://webdriver.io"); + assert.strictEqual(result.url, "https://testplane.io"); assert.strictEqual( result.title, - "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js", + "Testplane Docs | Testplane Docs", ); assert.strictEqual(result.customParam, "foobar"); }); diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/overwriteCommand.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/overwriteCommand.mdx index ac94f46..be494be 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/overwriteCommand.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/commands/browser/overwriteCommand.mdx @@ -19,25 +19,40 @@ await browser.overwriteCommand(name, callback, elementScope); ## Параметры команды {#parameters} - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + +
**Имя****Тип****Описание**
nameStringИмя кастомной команды.
callbackFunctionФункция-реализация команды.
elementScopeBooleanЕсли значение _true_, то добавить команду к элементу, а не к браузеру. По умолчанию: _false_.
**Имя****Тип****Описание**
nameStringИмя кастомной команды.
callbackFunctionФункция-реализация команды.
elementScopeBooleanЕсли значение _true_, то добавить команду к элементу, а не к браузеру. По умолчанию: _false_.
## Примеры использования {#examples} ```javascript // вывести время паузы в мс перед самой паузой и вернуть потом это значение -await browser.overwriteCommand("pause", function (origPauseFunction, ms) { +await browser.overwriteCommand("pause", async function (origPauseFunction, ms) { console.log(`Sleeping for ${ms}`); - origPauseFunction(ms); + await origPauseFunction(ms); return ms; });