From ab4b861572d702a47686749b9e0249bd75fa07af 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 | 49 ++++++++++++------- docs/commands/browser/overwriteCommand.mdx | 39 ++++++++++----- .../current/commands/browser/addCommand.mdx | 49 ++++++++++++------- .../commands/browser/overwriteCommand.mdx | 40 ++++++++++----- 4 files changed, 121 insertions(+), 56 deletions(-) diff --git a/docs/commands/browser/addCommand.mdx b/docs/commands/browser/addCommand.mdx index 3e69e17..be16c61 100644 --- a/docs/commands/browser/addCommand.mdx +++ b/docs/commands/browser/addCommand.mdx @@ -14,28 +14,46 @@ 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.
elementScopeBoolean + If 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,15 +63,12 @@ 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.title, - "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js", - ); + assert.strictEqual(result.url, "https://testplane.io"); + assert.strictEqual(result.title, "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..3872381 100644 --- a/docs/commands/browser/overwriteCommand.mdx +++ b/docs/commands/browser/overwriteCommand.mdx @@ -19,25 +19,42 @@ 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..f856cdf 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,46 @@ 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,15 +63,12 @@ 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.title, - "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js", - ); + assert.strictEqual(result.url, "https://testplane.io"); + assert.strictEqual(result.title, "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..027754e 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,43 @@ 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; });