Pular para o conteúdo principal

Configuração

Baseado no tipo de configuração (por exemplo, usando as ligações de protocolo brutas, WebdriverIO como pacote autônomo ou o testrunner WDIO), há um conjunto diferente de opções disponíveis para controlar o ambiente.

Opções do WebDriver

As seguintes opções são definidas ao usar o pacote de protocolo webdriver:

protocol

Protocolo a ser usado ao comunicar-se com o servidor do driver.

Tipo: String
Padrão: http

hostname

Host do seu servidor de driver.

Tipo: String
Padrão: 0.0.0.0

port

Porta em que seu servidor de driver está.

Tipo: Number
Padrão: undefined

path

Caminho para o endpoint do servidor de driver.

Tipo: String
Padrão: /

queryParams

Parâmetros de consulta que são propagados para o servidor de driver.

Tipo: Object
Padrão: undefined

user

Seu nome de usuário do serviço na nuvem (funciona apenas para contas Sauce Labs, Browserstack, TestingBot ou LambdaTest). Se definido, o WebdriverIO definirá automaticamente as opções de conexão para você. Se você não usar um provedor de nuvem, isso pode ser usado para autenticar qualquer outro backend WebDriver.

Tipo: String
Padrão: undefined

key

Sua chave de acesso ou chave secreta do serviço na nuvem (funciona apenas para contas Sauce Labs, Browserstack, TestingBot ou LambdaTest). Se definido, o WebdriverIO definirá automaticamente as opções de conexão para você. Se você não usar um provedor de nuvem, isso pode ser usado para autenticar qualquer outro backend WebDriver.

Tipo: String
Padrão: undefined

capabilities

Define as capacidades que você deseja executar em sua sessão WebDriver. Confira o Protocolo WebDriver para mais detalhes. Se você executar um driver mais antigo que não suporta o protocolo WebDriver, precisará usar as capacidades JSONWireProtocol para executar uma sessão com sucesso.

Além das capacidades baseadas no WebDriver, você pode aplicar opções específicas de navegador e fornecedor que permitem uma configuração mais profunda do navegador remoto ou dispositivo. Estas estão documentadas nas respectivas documentações do fornecedor, por exemplo:

Além disso, uma ferramenta útil é o Configurador de Teste Automatizado do Sauce Labs, que ajuda você a criar este objeto clicando juntas as capacidades desejadas.

Tipo: Object
Padrão: null

Exemplo:

{
browserName: 'chrome', // opções: `chrome`, `edge`, `firefox`, `safari`
browserVersion: '27.0', // versão do navegador
platformName: 'Windows 10' // plataforma do SO
}

Se você estiver executando testes da web ou nativos em dispositivos móveis, capabilities difere do protocolo WebDriver. Consulte a Documentação do Appium para mais detalhes.

logLevel

Nível de verbosidade do registro.

Tipo: String
Padrão: info
Opções: trace | debug | info | warn | error | silent

outputDir

Diretório para armazenar todos os arquivos de log do testrunner (incluindo logs de repórter e logs wdio). Se não estiver definido, todos os logs são transmitidos para stdout. Como a maioria dos repórteres é feita para registrar em stdout, é recomendável usar esta opção apenas para repórteres específicos onde faz mais sentido enviar o relatório para um arquivo (como o repórter junit, por exemplo).

Quando executado no modo autônomo, o único log gerado pelo WebdriverIO será o log wdio.

Tipo: String
Padrão: null

connectionRetryTimeout

Tempo limite para qualquer solicitação WebDriver a um driver ou grid.

Tipo: Number
Padrão: 120000

connectionRetryCount

Contagem máxima de tentativas de solicitação ao servidor Selenium.

Tipo: Number
Padrão: 3

agent

Permite que você use um agente personalizado http/https/http2 agent para fazer solicitações.

Tipo: Object
Padrão:

{
http: new http.Agent({ keepAlive: true }),
https: new https.Agent({ keepAlive: true })
}

headers

Especifique headers personalizados para passar em todas as solicitações WebDriver. Se o seu Selenium Grid requer autenticação básica, recomendamos passar um cabeçalho Authorization através desta opção para autenticar suas solicitações WebDriver, por exemplo:

import { Buffer } from 'buffer';
// Read the username and password from environment variables
const username = process.env.SELENIUM_GRID_USERNAME;
const password = process.env.SELENIUM_GRID_PASSWORD;

// Combine the username and password with a colon separator
const credentials = `${username}:${password}`;
// Encode the credentials using Base64
const encodedCredentials = Buffer.from(credentials).toString('base64');

export const config: WebdriverIO.Config = {
// ...
headers: {
Authorization: `Basic ${encodedCredentials}`
}
// ...
}

Tipo: Object
Padrão: {}

transformRequest

Função que intercepta opções de solicitação HTTP antes que uma solicitação WebDriver seja feita

Tipo: (RequestOptions) => RequestOptions
Padrão: nenhum

transformResponse

Função que intercepta objetos de resposta HTTP após a chegada de uma resposta WebDriver. A função recebe o objeto de resposta original como primeiro e as RequestOptions correspondentes como segundo argumento.

Tipo: (Response, RequestOptions) => Response
Padrão: nenhum

strictSSL

Se não requer que o certificado SSL seja válido. Pode ser definido através de variáveis de ambiente como STRICT_SSL ou strict_ssl.

Tipo: Boolean
Padrão: true

enableDirectConnect

Se habilita o recurso de conexão direta do Appium. Não faz nada se a resposta não tiver as chaves apropriadas enquanto a flag estiver habilitada.

Tipo: Boolean
Padrão: true

cacheDir

O caminho para a raiz do diretório de cache. Este diretório é usado para armazenar todos os drivers que são baixados ao tentar iniciar uma sessão.

Tipo: String
Padrão: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

maskingPatterns

Para um registro mais seguro, expressões regulares definidas com maskingPatterns podem ofuscar informações sensíveis do log.

Tipo: String
Padrão: undefined

Exemplo:

{
maskingPatterns: '/--key=([^ ]*)/i,/RESULT (.*)/'
}

WebdriverIO

As seguintes opções (incluindo as listadas acima) podem ser usadas com o WebdriverIO de forma autônoma:

automationProtocol

Defina o protocolo que você deseja usar para sua automação de navegador. Atualmente, apenas webdriver é suportado, pois é a principal tecnologia de automação de navegador que o WebdriverIO usa.

Se você quiser automatizar o navegador usando uma tecnologia de automação diferente, certifique-se de definir esta propriedade para um caminho que resolva para um módulo que adere à seguinte interface:

import type { Capabilities } from '@wdio/types';
import type { Client, AttachOptions } from 'webdriver';

export default class YourAutomationLibrary {
/**
* Start a automation session and return a WebdriverIO [monad](https://github.com/webdriverio/webdriverio/blob/940cd30939864bdbdacb2e94ee6e8ada9b1cc74c/packages/wdio-utils/src/monad.ts)
* with respective automation commands. See the [webdriver](https://www.npmjs.com/package/webdriver) package
* as a reference implementation
*
* @param {Capabilities.RemoteConfig} options WebdriverIO options
* @param {Function} hook that allows to modify the client before it gets released from the function
* @param {PropertyDescriptorMap} userPrototype allows user to add custom protocol commands
* @param {Function} customCommandWrapper allows to modify the command execution
* @returns a WebdriverIO compatible client instance
*/
static newSession(
options: Capabilities.RemoteConfig,
modifier?: (...args: any[]) => any,
userPrototype?: PropertyDescriptorMap,
customCommandWrapper?: (...args: any[]) => any
): Promise<Client>;

/**
* allows user to attach to existing sessions
* @optional
*/
static attachToSession(
options?: AttachOptions,
modifier?: (...args: any[]) => any, userPrototype?: {},
commandWrapper?: (...args: any[]) => any
): Client;

/**
* Changes The instance session id and browser capabilities for the new session
* directly into the passed in browser object
*
* @optional
* @param {object} instance the object we get from a new browser session.
* @returns {string} the new session id of the browser
*/
static reloadSession(
instance: Client,
newCapabilities?: WebdriverIO.Capabilitie
): Promise<string>;
}

Tipo: String
Padrão: webdriver

baseUrl

Abrevie chamadas do comando url definindo uma URL base.

  • Se o seu parâmetro url começar com /, então o baseUrl é prefixado (exceto o caminho baseUrl, se tiver um).
  • Se o seu parâmetro url começar sem um esquema ou / (como some/path), então o baseUrl completo é prefixado diretamente.

Tipo: String
Padrão: null

waitforTimeout

Tempo limite padrão para todos os comandos waitFor*. (Note o 'f' minúsculo no nome da opção.) Este tempo limite apenas afeta comandos que começam com waitFor* e seu tempo de espera padrão.

Para aumentar o tempo limite para um teste, consulte a documentação do framework.

Tipo: Number
Padrão: 5000

waitforInterval

Intervalo padrão para todos os comandos waitFor* para verificar se um estado esperado (por exemplo, visibilidade) foi alterado.

Tipo: Number
Padrão: 100

region

Se estiver executando no Sauce Labs, você pode escolher executar testes entre diferentes data centers: US ou EU. Para mudar sua região para EU, adicione region: 'eu' à sua configuração.

Nota: Isso só tem efeito se você fornecer as opções user e key que estão conectadas à sua conta Sauce Labs.

Tipo: String
Padrão: us

(apenas para vm e/ou em/simuladores)


Opções do Testrunner

As seguintes opções (incluindo as listadas acima) são definidas apenas para executar o WebdriverIO com o testrunner WDIO:

specs

Define especificações para execução de teste. Você pode especificar um padrão glob para corresponder a vários arquivos de uma vez ou agrupar um glob ou conjunto de caminhos em uma matriz para executá-los dentro de um único processo de trabalho. Todos os caminhos são vistos como relativos ao caminho do arquivo de configuração.

Tipo: (String | String[])[]
Padrão: []

exclude

Exclui especificações da execução do teste. Todos os caminhos são vistos como relativos ao caminho do arquivo de configuração.

Tipo: String[]
Padrão: []

suites

Um objeto descrevendo várias suítes, que você pode então especificar com a opção --suite na CLI wdio.

Tipo: Object
Padrão: {}

capabilities

O mesmo que a seção capabilities descrita acima, exceto com a opção de especificar um objeto multiremote ou várias sessões WebDriver em uma matriz para execução paralela.

Você pode aplicar as mesmas capacidades específicas de fornecedor e navegador conforme definido acima.

Tipo: Object|Object[]
Padrão: [{ 'wdio:maxInstances': 5, browserName: 'firefox' }]

maxInstances

Número máximo total de trabalhadores paralelos em execução.

Nota: que pode ser um número tão alto quanto 100, quando os testes estão sendo realizados em alguns fornecedores externos, como máquinas do Sauce Labs. Lá, os testes não são testados em uma única máquina, mas sim em várias VMs. Se os testes forem executados em uma máquina de desenvolvimento local, use um número mais razoável, como 3, 4 ou 5. Essencialmente, este é o número de navegadores que serão iniciados simultaneamente e executando seus testes ao mesmo tempo, portanto, depende de quanta RAM existe em sua máquina e quantos outros aplicativos estão sendo executados em sua máquina.

Você também pode aplicar maxInstances dentro de seus objetos de capacidade usando a capacidade wdio:maxInstances. Isso limitará a quantidade de sessões paralelas para essa capacidade específica.

Tipo: Number
Padrão: 100

maxInstancesPerCapability

Número máximo total de trabalhadores paralelos em execução por capacidade.

Tipo: Number
Padrão: 100

injectGlobals

Insere os globais do WebdriverIO (por exemplo, browser, $ e $$) no ambiente global. Se você definir como false, deverá importar de @wdio/globals, por exemplo:

import { browser, $, $$, expect } from '@wdio/globals'

Nota: O WebdriverIO não lida com a injeção de globais específicos do framework de teste.

Tipo: Boolean
Padrão: true

bail

Se você quiser que sua execução de teste pare após um número específico de falhas de teste, use bail. (O padrão é 0, que executa todos os testes, não importa o quê.) Nota: Um teste neste contexto são todos os testes dentro de um único arquivo de especificação (ao usar Mocha ou Jasmine) ou todas as etapas dentro de um arquivo de recursos (ao usar Cucumber). Se você quiser controlar o comportamento de bail dentro de testes de um único arquivo de teste, dê uma olhada nas opções disponíveis do framework.

Tipo: Number
Padrão: 0 (não interrompe; executa todos os testes)

specFileRetries

O número de vezes para tentar novamente um arquivo de especificação inteiro quando ele falha como um todo.

Tipo: Number
Padrão: 0

specFileRetriesDelay

Atraso em segundos entre as tentativas de arquivo de especificação

Tipo: Number
Padrão: 0

specFileRetriesDeferred

Se os arquivos de especificação repetidos devem ser repetidos imediatamente ou adiados para o final da fila.

Tipo: Boolean
Padrão: true

groupLogsByTestSpec

Escolha a visualização de saída de log.

Se definido como false, os logs de diferentes arquivos de teste serão impressos em tempo real. Observe que isso pode resultar na mistura de saídas de log de diferentes arquivos quando executados em paralelo.

Se definido como true, as saídas de log serão agrupadas por Test Spec e impressas apenas quando o Test Spec for concluído.

Por padrão, é definido como false, para que os logs sejam impressos em tempo real.

Tipo: Boolean
Padrão: false

autoAssertOnTestEnd

Controla se o WebdriverIO verifica automaticamente todas as asserções suaves no final de cada teste. Quando definido como true, quaisquer asserções suaves acumuladas serão verificadas automaticamente e causarão a falha do teste se alguma asserção falhar. Quando definido como false, você deve chamar o método assert manualmente para verificar asserções suaves.

Tipo: Boolean
Padrão: true

services

Os serviços assumem um trabalho específico que você não quer cuidar. Eles aprimoram sua configuração de teste com quase nenhum esforço.

Tipo: String[]|Object[]
Padrão: []

framework

Define o framework de teste a ser usado pelo testrunner WDIO.

Tipo: String
Padrão: mocha
Opções: mocha | jasmine

mochaOpts, jasmineOpts e cucumberOpts

Opções específicas relacionadas ao framework. Veja a documentação do adaptador do framework sobre quais opções estão disponíveis. Leia mais sobre isso em Frameworks.

Tipo: Object
Padrão: { timeout: 10000 }

cucumberFeaturesWithLineNumbers

Lista de recursos do cucumber com números de linha (ao usar o framework cucumber).

Tipo: String[] Padrão: []

reporters

Lista de repórteres a serem usados. Um repórter pode ser uma string ou uma matriz de ['reporterName', { /* reporter options */}] onde o primeiro elemento é uma string com o nome do repórter e o segundo elemento é um objeto com opções do repórter.

Tipo: String[]|Object[]
Padrão: []

Exemplo:

reporters: [
'dot',
'spec'
['junit', {
outputDir: `${__dirname}/reports`,
otherOption: 'foobar'
}]
]

reporterSyncInterval

Determina em qual intervalo o repórter deve verificar se estão sincronizados se relatarem seus logs de forma assíncrona (por exemplo, se os logs forem transmitidos para um fornecedor terceirizado).

Tipo: Number
Padrão: 100 (ms)

reporterSyncTimeout

Determina o tempo máximo que os repórteres têm para terminar de fazer upload de todos os seus logs até que um erro seja lançado pelo testrunner.

Tipo: Number
Padrão: 5000 (ms)

execArgv

Argumentos do Node para especificar ao iniciar processos filhos.

Tipo: String[]
Padrão: null

filesToWatch

Uma lista de padrões de string que suportam glob que informam ao testrunner para observar outros arquivos adicionalmente, por exemplo, arquivos de aplicativos, ao executá-lo com a flag --watch. Por padrão, o testrunner já observa todos os arquivos de especificação.

Tipo: String[]
Padrão: []

updateSnapshots

Defina como true se você quiser atualizar seus snapshots. Idealmente usado como parte de um parâmetro CLI, por exemplo, wdio run wdio.conf.js --s.

Tipo: 'new' | 'all' | 'none'
Padrão: none se não fornecido e os testes são executados no CI, new se não fornecido, caso contrário, o que foi fornecido

resolveSnapshotPath

Substitui o caminho padrão do snapshot. Por exemplo, para armazenar snapshots ao lado dos arquivos de teste.

wdio.conf.ts
export const config: WebdriverIO.Config = {
resolveSnapshotPath: (testPath, snapExtension) => testPath + snapExtension,
}

Tipo: (testPath: string, snapExtension: string) => string
Padrão: armazena arquivos de snapshot no diretório __snapshots__ ao lado do arquivo de teste

tsConfigPath

O WDIO usa tsx para compilar arquivos TypeScript. Seu TSConfig é automaticamente detectado do diretório de trabalho atual, mas você pode especificar um caminho personalizado aqui ou definindo a variável de ambiente TSX_TSCONFIG_PATH.

Veja a documentação do tsx: https://tsx.is/dev-api/node-cli#custom-tsconfig-json-path

Tipo: String
Padrão: null

Hooks

O testrunner WDIO permite que você defina hooks para serem acionados em momentos específicos do ciclo de vida do teste. Isso permite ações personalizadas (por exemplo, tirar uma captura de tela se um teste falhar).

Cada hook tem como parâmetro informações específicas sobre o ciclo de vida (por exemplo, informações sobre a suíte de teste ou teste). Leia mais sobre todas as propriedades do hook em nossa configuração de exemplo.

Nota: Alguns hooks (onPrepare, onWorkerStart, onWorkerEnd e onComplete) são executados em um processo diferente e, portanto, não podem compartilhar dados globais com os outros hooks que vivem no processo de trabalho.

onPrepare

É executado uma vez antes que todos os trabalhadores sejam lançados.

Parâmetros:

  • config (object): objeto de configuração WebdriverIO
  • param (object[]): lista de detalhes de capacidades

onWorkerStart

É executado antes que um processo de trabalho seja gerado e pode ser usado para inicializar serviços específicos para esse trabalhador, bem como modificar ambientes de tempo de execução de forma assíncrona.

Parâmetros:

  • cid (string): id de capacidade (por exemplo, 0-0)
  • caps (object): contendo capacidades para a sessão que será gerada no trabalhador
  • specs (string[]): especificações a serem executadas no processo de trabalho
  • args (object): objeto que será mesclado com a configuração principal depois que o trabalhador for inicializado
  • execArgv (string[]): lista de argumentos de string passados para o processo de trabalho

onWorkerEnd

É executado logo após um processo de trabalho ter saído.

Parâmetros:

beforeSession

É executado logo antes de inicializar a sessão do webdriver e o framework de teste. Permite manipular configurações dependendo da capacidade ou especificação.

Parâmetros:

  • config (object): objeto de configuração WebdriverIO
  • caps (object): contendo capacidades para a sessão que será gerada no trabalhador
  • specs (string[]): especificações a serem executadas no processo de trabalho

before

É executado antes do início da execução do teste. Neste ponto, você pode acessar todas as variáveis globais como browser. É o lugar perfeito para definir comandos personalizados.

Parâmetros:

  • caps (object): contendo capacidades para a sessão que será gerada no trabalhador
  • specs (string[]): especificações a serem executadas no processo de trabalho
  • browser (object): instância da sessão de navegador/dispositivo criada

beforeSuite

Hook que é executado antes do início da suíte (apenas em Mocha/Jasmine)

Parâmetros:

  • suite (object): detalhes da suíte

beforeHook

Hook que é executado antes de um hook dentro da suíte iniciar (por exemplo, é executado antes de chamar beforeEach no Mocha)

Parâmetros:

  • test (object): detalhes do teste
  • context (object): contexto do teste (representa o objeto World no Cucumber)

afterHook

Hook que é executado depois que um hook dentro da suíte termina (por exemplo, é executado depois de chamar afterEach no Mocha)

Parâmetros:

  • test (object): detalhes do teste
  • context (object): contexto do teste (representa o objeto World no Cucumber)
  • result (object): resultado do hook (contém propriedades error, result, duration, passed, retries)

beforeTest

Função a ser executada antes de um teste (apenas em Mocha/Jasmine).

Parâmetros:

  • test (object): detalhes do teste
  • context (object): objeto de escopo com o qual o teste foi executado

beforeCommand

Executa antes que um comando WebdriverIO seja executado.

Parâmetros:

  • commandName (string): nome do comando
  • args (*): argumentos que o comando receberia

afterCommand

Executa após um comando WebdriverIO ser executado.

Parâmetros:

  • commandName (string): nome do comando
  • args (*): argumentos que o comando receberia
  • result (number): 0 - comando bem-sucedido, 1 - erro de comando
  • error (Error): objeto de erro se houver algum

afterTest

Função a ser executada após o término de um teste (em Mocha/Jasmine).

Parâmetros:

  • test (object): detalhes do teste
  • context (object): objeto de escopo com o qual o teste foi executado
  • result.error (Error): objeto de erro caso o teste falhe, caso contrário undefined
  • result.result (Any): objeto de retorno da função de teste
  • result.duration (Number): duração do teste
  • result.passed (Boolean): verdadeiro se o teste passou, caso contrário falso
  • result.retries (Object): informações sobre novas tentativas de testes únicos conforme definido para Mocha e Jasmine e Cucumber, por exemplo, { attempts: 0, limit: 0 }, veja
  • result (object): resultado do hook (contém propriedades error, result, duration, passed, retries)

afterSuite

Hook que é executado após o término da suíte (apenas em Mocha/Jasmine)

Parâmetros:

  • suite (object): detalhes da suíte

after

É executado após a conclusão de todos os testes. Você ainda tem acesso a todas as variáveis globais do teste.

Parâmetros:

  • result (number): 0 - teste passou, 1 - teste falhou
  • caps (object): contendo capacidades para a sessão que será gerada no trabalhador
  • specs (string[]): especificações a serem executadas no processo de trabalho

afterSession

É executado logo após o término da sessão do webdriver.

Parâmetros:

  • config (object): objeto de configuração WebdriverIO
  • caps (object): contendo capacidades para a sessão que será gerada no trabalhador
  • specs (string[]): especificações a serem executadas no processo de trabalho

onComplete

É executado depois que todos os trabalhadores foram desligados e o processo está prestes a sair. Um erro lançado no hook onComplete resultará na falha da execução do teste.

Parâmetros:

  • exitCode (number): 0 - sucesso, 1 - falha
  • config (object): objeto de configuração WebdriverIO
  • caps (object): contendo capacidades para a sessão que será gerada no trabalhador
  • result (object): objeto de resultados contendo resultados de teste

onReload

É executado quando ocorre uma atualização.

Parâmetros:

  • oldSessionId (string): ID da sessão antiga
  • newSessionId (string): ID da sessão nova

beforeFeature

Executa antes de um Recurso do Cucumber.

Parâmetros:

afterFeature

Executa após um Recurso do Cucumber.

Parâmetros:

beforeScenario

Executa antes de um Cenário do Cucumber.

Parâmetros:

  • world (ITestCaseHookParameter): objeto world contendo informações sobre pickle e etapa de teste
  • context (object): objeto World do Cucumber

afterScenario

Executa após um Cenário do Cucumber.

Parâmetros:

  • world (ITestCaseHookParameter): objeto world contendo informações sobre pickle e etapa de teste
  • result (object): objeto de resultados contendo resultados do cenário
  • result.passed (boolean): verdadeiro se o cenário passou
  • result.error (string): pilha de erros se o cenário falhou
  • result.duration (number): duração do cenário em milissegundos
  • context (object): objeto World do Cucumber

beforeStep

Executa antes de uma Etapa do Cucumber.

Parâmetros:

  • step (Pickle.IPickleStep): objeto de etapa do Cucumber
  • scenario (IPickle): objeto de cenário do Cucumber
  • context (object): objeto World do Cucumber

afterStep

Executa após uma Etapa do Cucumber.

Parâmetros:

  • step (Pickle.IPickleStep): objeto de etapa do Cucumber
  • scenario (IPickle): objeto de cenário do Cucumber
  • result: (object): objeto de resultados contendo resultados da etapa
  • result.passed (boolean): verdadeiro se o cenário passou
  • result.error (string): pilha de erros se o cenário falhou
  • result.duration (number): duração do cenário em milissegundos
  • context (object): objeto World do Cucumber

beforeAssertion

Hook que é executado antes de uma asserção WebdriverIO acontecer.

Parâmetros:

  • params: informações de asserção
  • params.matcherName (string): nome do matcher (por exemplo, toHaveTitle)
  • params.expectedValue: valor que é passado para o matcher
  • params.options: opções de asserção

afterAssertion

Hook que é executado após uma asserção WebdriverIO acontecer.

Parâmetros:

  • params: informações de asserção
  • params.matcherName (string): nome do matcher (por exemplo, toHaveTitle)
  • params.expectedValue: valor que é passado para o matcher
  • params.options: opções de asserção
  • params.result: resultados da asserção

Welcome! How can I help?

WebdriverIO AI Copilot