# addCommand

The browser method `addCommand` helps you to write your own set of commands.

info

You can find more information on adding custom commands in the [custom command](/docs/customcommands.md#adding-custom-commands) guide.

## Usage[​](#usage "Direct link to Usage")

```
browser.addCommand(name, callback, { attachToElement, disableElementImplicitWait })
```

## Parameters[​](#parameters "Direct link to Parameters")

| Name                                                 | Type              | Details                                                                                   |
| ---------------------------------------------------- | ----------------- | ----------------------------------------------------------------------------------------- |
| `name`                                               | `string`          | name of the custom command                                                                |
| `callback`                                           | `Function`        | function to be called                                                                     |
| `options`<br />*optional*                            | `Boolean, Object` | **DEPRECATED when Boolean (elementScope)**. Options object with the following properties: |
| `options.attachToElement`<br />*optional*            | `Boolean`         | extend the Element object instead of the Browser object                                   |
| `options.disableElementImplicitWait`<br />*optional* | `Boolean`         | disable implicit wait for element commands                                                |

## Example[​](#example "Direct link to Example")

execute.js

```
// Basic usage with browser scope
await browser.addCommand('getUrlAndTitle', async function (customParam) {
    // `this` refers to the `browser` scope
    return {
        url: await this.getUrl(),
        title: await this.getTitle(),
        customParam: customParam
    }
})

// Element scope using options object (RECOMMENDED)
await browser.addCommand('waitAndClick', async function () {
    // `this` refers to the `element` scope
    await this.waitForClickable()
    await this.click()
}, { attachToElement: true })

// Advanced usage with options
await browser.addCommand('fastClick', async function () {
    // `this` refers to the `element` scope
    await this.click()
}, {
    attachToElement: true,
    disableElementImplicitWait: true // Skip implicit wait for faster execution
})

//usage
it('should use my add command', async () => {
    await browser.url('https://webdriver.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 | WebdriverIO')
    assert.strictEqual(result.customParam, 'foobar')

    // Using element commands
    const element = await $('button')
    await element.waitAndClick()
    await element.fastClick()
})
```