Repolode
Enviar
codeceptjs

codeceptjs/CodeceptJS

Framework JavaScript de testes end-to-end que permite escrever testes para navegador e dispositivos móveis em etapas legíveis, do ponto de vista do usuário, em diferentes engines.

Ver no GitHubSite
Estrelas
4,252
Forks
756
Issues abertas
189
Último commit
há 15 horas

O que é?

CodeceptJS é um framework de testes end-to-end para Node.js. Os testes são escritos como cenários compostos por etapas simples, como amOnPage, fillField e see, descritas do ponto de vista do usuário. O framework abstrai as diferenças entre APIs de automação de navegadores, permitindo executar a mesma sintaxe de teste no Playwright, Puppeteer, WebDriver (via webdriverio) e em vários navegadores headless leves.

Para testes em dispositivos móveis, o CodeceptJS oferece helpers para Appium e Detox; o Detox é voltado a testes grey-box de apps React Native. Os testes são executados com Mocha, oferecem suporte a TypeScript e incluem geradores CLI para testes e page objects. Um shell interativo permite pausar um teste e experimentar comandos no navegador em execução.

O projeto também inclui recursos de IA integrados para ajudar a corrigir testes com falhas, execução paralela de testes e um relatório HTML. É o sucessor do Codeception, framework de testes para PHP.

Recursos principais

  • 01Escreve testes como etapas do ponto de vista do usuário, executáveis no Playwright, Puppeteer, WebDriver e outras engines.
  • 02Oferece suporte a testes em dispositivos móveis por meio de helpers para Appium e Detox.
  • 03Disponibiliza um shell interativo para pausar testes e experimentar comandos em um navegador em execução.
  • 04Executa testes em paralelo com distribuição dinâmica entre workers.
  • 05Inclui recursos de IA para ajudar a corrigir testes com falhas, além de um relatório HTML integrado.
  • 06Oferece geradores CLI para testes e page objects, com suporte a TypeScript.

Casos de uso

  • Escrever testes de aceitação para uma aplicação web que devem ser executados em várias engines de navegador.
  • Criar suítes E2E legíveis que pessoas fora da área de engenharia também possam acompanhar.
  • Testar apps React Native com testes grey-box no Detox.
  • Migrar testes funcionais do Codeception ou de frameworks semelhantes para Node.js.

Início rápido

  1. 1

    Instale o CodeceptJS pelo npm

    npm i codeceptjs --save
  2. 2

    Inicialize o ambiente de testes no diretório de testes e escolha os helpers

    npx codeceptjs init
  3. 3

    Gere seu primeiro teste

    npx codeceptjs generate:test
  4. 4

    Execute os testes

    npx codeceptjs run

Antes de usar

  • A versão 4.2 requer Node.js 22.12.0 ou posterior.
  • Os testes para dispositivos móveis com Appium são mostrados apenas para Android no status do build.

Em coleções

Frameworks de teste e ferramentas de automação de testes

Tópicos

#end-to-end-testing#testing#playwright#webdriver#nodejs#bdd#acceptance-testing#mobile-testing#bdd-framework#codeceptjs

Perguntas frequentes

O que é CodeceptJS?
Framework JavaScript de testes end-to-end que permite escrever testes para navegador e dispositivos móveis em etapas legíveis, do ponto de vista do usuário, em diferentes engines. CodeceptJS é um framework de testes end-to-end para Node.js. Os testes são escritos como cenários compostos por etapas simples, como amOnPage, fillField e see, descritas do ponto de vista do usuário. O framework abstrai as diferenças entre APIs de automação de navegadores, permitindo executar a mesma sintaxe de teste no Playwright, Puppeteer, WebDriver (via webdriverio) e em vários navegadores headless leves.
CodeceptJS é gratuito? Qual é a licença?
CodeceptJS é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
CodeceptJS ainda é mantido?
Manutenção ativa. O último commit de CodeceptJS foi em 6 de nov. de 2026.
Para que posso usar CodeceptJS?
Escrever testes de aceitação para uma aplicação web que devem ser executados em várias engines de navegador. Criar suítes E2E legíveis que pessoas fora da área de engenharia também possam acompanhar. Testar apps React Native com testes grey-box no Detox. Migrar testes funcionais do Codeception ou de frameworks semelhantes para Node.js.
Como instalar CodeceptJS?
Instale o CodeceptJS pelo npm: npm i codeceptjs --save Inicialize o ambiente de testes no diretório de testes e escolha os helpers: npx codeceptjs init Gere seu primeiro teste: npx codeceptjs generate:test Execute os testes: npx codeceptjs run
Onde consigo CodeceptJS?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/codeceptjs/CodeceptJS

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados