<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Jonas Davila on Medium]]></title>
        <description><![CDATA[Stories by Jonas Davila on Medium]]></description>
        <link>https://medium.com/@jonasdaviladasilva?source=rss-4fdb4b1bb5c8------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*yvUrMSFopoTvtp4nmXxoVg.jpeg</url>
            <title>Stories by Jonas Davila on Medium</title>
            <link>https://medium.com/@jonasdaviladasilva?source=rss-4fdb4b1bb5c8------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 14:19:50 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@jonasdaviladasilva/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Pare de usar Page Objects e comece a usar App Actions]]></title>
            <link>https://medium.com/@jonasdaviladasilva/pare-de-usar-page-objects-e-comece-a-usar-app-actions-dd6ca931ecf6?source=rss-4fdb4b1bb5c8------2</link>
            <guid isPermaLink="false">https://medium.com/p/dd6ca931ecf6</guid>
            <dc:creator><![CDATA[Jonas Davila]]></dc:creator>
            <pubDate>Thu, 16 Nov 2023 00:25:22 GMT</pubDate>
            <atom:updated>2023-11-16T17:00:28.219Z</atom:updated>
            <content:encoded><![CDATA[<p>Link com texto original:<a href="https://www.cypress.io/blog/2019/01/03/stop-using-page-objects-and-start-using-app-actions/">https://www.cypress.io/blog/2019/01/03/stop-using-page-objects-and-start-using-app-actions/</a></p><p><em>O texto abaixo é a uma tradução do artigo escrito pelo Gleb Bahmutov. Para acessar a versão original em inglês, </em><a href="https://www.cypress.io/blog/2019/01/03/stop-using-page-objects-and-start-using-app-actions/"><em>clique aqui</em></a><em>. Caso você tenha sugestões para tornar a tradução melhor, compartilhe através da seção de comentários no final da página.</em></p><p><em>The below text is a translation of an article written by Gleb Bahmutov. To access the original English version, </em><a href="https://www.cypress.io/blog/2019/01/03/stop-using-page-objects-and-start-using-app-actions/"><em>click here</em></a><em>. If you have suggestions for making the translation better, share it through the comments section at the bottom of the page.</em></p><p><em>Escrever testes de ponta a ponta sustentáveis ​​é um desafio. Frequentemente, testadores criam outra camada de abstração com base na página web chamada de Page Objects, para a execução de ações comuns. Neste post, defendo que os Page Objects são uma má prática e sugiro o envio de ações diretamente para a lógica interna da aplicação. Isso funciona muito bem com o moderno runner de testes do Cypress.io, que executa o código de teste diretamente ao lado do código da aplicação.</em></p><h3>Page objects</h3><p>Page Objects <a href="https://github.com/SeleniumHQ/selenium/wiki/PageObjects">1</a>, <a href="https://www.linkedin.com/pulse/page-object-pattern-javascript-vladim%C3%ADr-gorej/">2</a> têm como objetivo tornar os testes de ponta a ponta legíveis e fáceis de manter. Em vez de interações ad-hoc com uma página, um teste controla a página usando uma instância que representa a interface do usuário de tal página. Por exemplo, aqui está uma abstração de uma de página de login obtida diretamente da página Wiki do Selenium .</p><pre>public class LoginPage {<br>private final WebDriver driver;<br>public LoginPage(WebDriver driver) {<br>this.driver = driver;<br>// Verifica se estamos na página certa.<br>if (!&quot;Login&quot;.equals(driver.getTitle())) {<br>// Alternatively, we could navigate to the<br>// login page, perhaps logging out first<br>throw new IllegalStateException(&quot;This is not the login page&quot;);<br>}<br>}<br>// A página de login contém vários elementos HTML<br>// Que serão representados como WebElements.<br>// Os localizadores para esses elementos devem ser definidos apenas uma vez..<br>By usernameLocator = By.id(&quot;username&quot;);<br>By passwordLocator = By.id(&quot;password&quot;);<br>By loginButtonLocator = By.id(&quot;login&quot;);<br>// A página de login permite que o usuário digite seu<br>// nome de usuário no campo nome de usuário<br>public LoginPage typeUsername(String username) {<br>// Este é o único lugar que &quot;sabe&quot; como inserir um nome de usuário<br>driver.findElement(usernameLocator).sendKeys(username);<br>// Retorne o objeto de página atual, pois esta ação não<br>// navegar até uma página representada por outro PageObject<br>return this;<br>}<br>// outros métodos<br>// - typePassword<br>// - submitLogin<br>// - submitLoginExpectingFailure<br>// - loginAs<br>}</pre><p><strong><em>Page objects têm dois benefícios principais</em></strong></p><ol><li>Eles mantêm todos os seletores de elementos da página em um só lugar</li><li>Eles padronizam como os testes interagem com a página</li></ol><p>Um teste típico usaria Page objects assim, por exemplo:</p><pre>public void testLogin() {<br>LoginPage login = new LoginPage(driver);<br>login.typeUsername(&#39;username&#39;)<br>login.typePassword(&#39;username&#39;)<br>login.submitLogin()<br>}</pre><p>Martin Fowler em seu post <a href="https://martinfowler.com/bliki/PageObject.html">PageObject</a> descreve Page Objects como outra API no topo do HTML. Conceitualmente, ele está acima do HTML.</p><pre>Tests<br>- - - - - - - - -<br>Page Objects<br>~ ~ ~ ~ ~ ~ ~ ~ ~<br>HTML UI<br>- - - - - - - - -<br>Application code</pre><p>Os 4 níveis no diagrama acima têm 3 interfaces de acoplamento diferente.</p><ol><li>O código da aplicação para HTML é restrito</li><li>O HTML para o Page object é muito flexível</li><li>Os testes com relação aos Page Object são restritos</li></ol><p><strong>O acoplamento do código da aplicação a para a UI do HTML é muito rígida, </strong>pois o código renderiza os elementos HTML no DOM — existe um relacionamento um para um entre a função render no código e os elementos de saída no DOM.Tipos estáticos e linters ajudam a garantir que o código da aplicação seja consistente e o produza HTML corretamente.</p><p><strong>Tipos estáticos e linters ajudam a garantir que o código da aplicação é consistente e gera HTML com significado.</strong></p><p><strong>Page Objects são fracamente acoplados com relação ao HTML</strong>, por isso desenhei o limite usando caracteres ~ ~. Eles usam seletores para encontrar elementos, que NÃO são verificados por nenhum linter ou compilador de código! O código da aplicação pode mudar a qualquer momento, gerar uma estrutura DOM diferente ou classes de elementos diferentes, e os testes irão quebrar em tempo de execução sem nenhum aviso.</p><p>💡Somente por fins de curiosidade, isso é algo que temos implementado no GitLab.</p><p>Por fim, os Page Objects são restritos com relação aos testes — pois ambos os níveis estão no mesmo código e podem ser verificados pelo compilador para encontrar erros do(a) programador(a).</p><h3>Page objects no Cypress</h3><p>Você pode facilmente usar Page Objects nos testes com Cypress. Aqui está um exemplo típico no blog post, <a href="https://medium.com/reactbrasil/deep-diving-pageobject-pattern-and-using-it-with-cypress-e60b9d7d0d91">Deep diving PageObject pattern and using it with Cypress</a>. Uma classe Page Object típica chamada de SignInPage é semelhante à LoginPage do Selenium mostrada acima.</p><pre>class SignInPage {<br>visit() {<br>cy.visit(&#39;/signin&#39;);<br>}<br>getEmailError() {<br>return cy.get(`[data-testid=SignInEmailError]`);<br>}<br>getPasswordError() {<br>return cy.get(`[data-testid=SignInPasswordError]`);<br>}<br>fillEmail(value) {<br>const field = cy.get(`[data-testid=SignInEmailField]`);<br>field.clear();<br>field.type(value);<br>return this;<br>}<br>fillPassword(value) {<br>const field = cy.get(`[data-testid=SignInPasswordField]`);<br>field.clear();<br>field.type(value);<br>return this;<br>}<br>submit() {<br>const button = cy.get(`[data-testid=SignInSubmitButton]`);<br>button.click();<br>}<br>}<br>export default SignInPage;<br>Ao escrever um teste para a &quot;Home page&quot;, podemos reutilizar o SignInPage de outro Page Object<br>import Header from &#39;./Headers&#39;;<br>import SignInPage from &#39;./SignIn&#39;;<br>class HomePage {<br>constructor() {<br>this.header = new Header();<br>}<br>visit() {<br>cy.visit(&#39;/&#39;);<br>}<br>getUserAvatar() {<br>return cy.get(`[data-testid=UserAvatar]`);<br>}<br>goToSignIn() {<br>const link = this.header.getSignInLink();<br>link.click();<br>const signIn = new SignInPage();<br>return signIn;<br>}<br>}<br>export default HomePage;</pre><p>Ao escrever um teste para a “Home page”, podemos reutilizar o SignInPage de outro Page Object</p><pre>import Header from &#39;./Headers&#39;;<br>import SignInPage from &#39;./SignIn&#39;;<br>class HomePage {<br>constructor() {<br>this.header = new Header();<br>}<br>visit() {<br>cy.visit(&#39;/&#39;);<br>}<br>getUserAvatar() {<br>return cy.get(`[data-testid=UserAvatar]`);<br>}<br>goToSignIn() {<br>const link = this.header.getSignInLink();<br>link.click();<br>const signIn = new SignInPage();<br>return signIn;<br>}<br>}<br>export default HomePage;</pre><p>Esse é um cenário típico — você precisa escrever uma hierarquia de classes Page Object inteira, em que partes da página estão usando Page Objects diferentes, sendo composta por um design orientado a objetos. Um teste típico se parece com isso.</p><pre>import HomePage from &#39;../elements/pages/HomePage&#39;;<br>describe(&#39;Sign In&#39;, () =&gt; {<br>it(&#39;should show an error message on empty input&#39;, () =&gt; {<br>const home = new HomePage();<br>home.visit();<br>const signIn = home.goToSignIn();<br>signIn.submit();<br>signIn.getEmailError()<br>.should(&#39;exist&#39;)<br>.contains(&#39;Email is required&#39;);<br>signIn<br>.getPasswordError()<br>.should(&#39;exist&#39;)<br>.contains(&#39;Password is required&#39;);<br>});<br>// more tests<br>});</pre><p>O Cypress vem com um <em>bundler</em> JavaScript incluído; portanto, o código acima simplesmente funciona.</p><p>Você não precisa usar a implementação Page Object orientada a objeto. Você também pode mover a lógica típica para comandos reutilizáveis e customizados do Cypress que não possuem nenhum estado interno e apenas permitem a reutilização de código. Por exemplo, você pode implementar um comando de “login”.</p><pre>// in cypress/support/commands.js<br>Cypress.Commands.add(&#39;login&#39;, (username, password) =&gt; {<br>cy.get(&#39;#login-username&#39;).type(username)<br>cy.get(&#39;#login-password&#39;).type(password)<br>cy.get(&#39;#login&#39;).submit()<br>})</pre><p>Após adicionar um comando customizado, os testes podem usá-lo como qualquer comando interno.</p><pre>// cypress/integration/spec.js<br>it(&#39;logs in&#39;, () =&gt; {<br>cy.visit(&#39;/login&#39;)<br>cy.login(&#39;username&#39;, &#39;password&#39;)<br>})</pre><p>Observe que você não precisa sempre criar comandos customizados e funções simples de JavaScript funcionam da mesma forma (se não melhor, pois a etapa de verificação de tipo pode entender assinaturas de funções individuais).</p><pre>// cypress/integration/util.js<br>export const login = (username, password) =&gt; {<br>cy.get(&#39;#login-username&#39;).type(username)<br>cy.get(&#39;#login-password&#39;).type(password)<br>cy.get(&#39;#login&#39;).submit()<br>}<br>// cypress/integration/spec.js<br>import { login } from &#39;./util&#39;<br>it(&#39;logs in&#39;, () =&gt; {<br>cy.visit(&#39;/login&#39;)<br>login(&#39;username&#39;, &#39;password&#39;)<br>})</pre><h3>Problemas dos Page Objects</h3><p>Nas próximas seções, examinarei exemplos concretos em que o padrão Page Object fica aquém do que precisamos para escrever bons testes ponta-a-ponta.</p><ul><li>PageObjects são difíceis de manter e tomam tempo do desenvolvimento real da aplicação. Nunca vi Page Objects documentados o suficiente para realmente ajudar a escrever testes.</li><li>Page Objects introduzem estado adicional nos testes, que é separado do estado interno da aplicação. Isso dificulta a compreensão dos testes e falhas.</li><li>Page Objects tentam encaixar vários casos em uma interface uniforme, voltando à lógica condicional — um enorme <a href="https://on.cypress.io/conditional-testing">antipadrão em nossa opinião</a></li><li>Page Objects tornam os testes lentos pois forçam os testes a sempre passarem pela interface do usuário da aplicação.</li></ul><p>Não se desespere! Também mostrarei uma alternativa aos Page Objects que chamo de “App Action” que nossos testes de ponta a ponta podem usar. Acredito que App actions resolvem os problemas acima muito bem, tornando os testes de ponta-a-ponta rápidos e produtivos.</p><h3>Exemplo de adição de itens</h3><p>Vamos pegar os testes do <a href="http://todomvc.com/">TodoMVC </a>como exemplo. Primeiro, testaremos se o usuário pode inserir <em>todos</em> (itens a fazer em inglês). Usaremos o Cypress para fazer isso através da interface de usuário — assim como um usuário real digitaria itens.</p><pre>describe(&#39;TodoMVC&#39;, function () {<br>// set up these constants to match what TodoMVC does<br>let TODO_ITEM_ONE = &#39;buy some cheese&#39;<br>let TODO_ITEM_TWO = &#39;feed the cat&#39;<br>let TODO_ITEM_THREE = &#39;book a doctors appointment&#39;<br>beforeEach(function () {<br>cy.visit(&#39;/&#39;)<br>})<br>context(&#39;New Todo&#39;, function () {<br>it(&#39;should allow me to add todo items&#39;, function () {<br>cy.get(&#39;.new-todo&#39;).type(TODO_ITEM_ONE).type(&#39;{enter}&#39;)<br>cy.get(&#39;.todo-list li&#39;).eq(0).find(&#39;label&#39;).should(&#39;contain&#39;, TODO_ITEM_ONE)<br>cy.get(&#39;.new-todo&#39;).type(TODO_ITEM_TWO).type(&#39;{enter}&#39;)<br>cy.get(&#39;.todo-list li&#39;).eq(1).find(&#39;label&#39;).should(&#39;contain&#39;, TODO_ITEM_TWO)<br>})<br>// more tests for adding items<br>// - adds items<br>// - should clear text input field when an item is added<br>// - should append new items to the bottom of the list<br>// - should trim text input<br>// - should show #main and #footer when items added<br>})<br>})</pre><p>Todos esses testes dentro do bloco “New Todo” inserem itens usando o elemento &lt;input class = “new-todo” /&gt; sem usar nenhum atalho. Aqui estão esses testes sendo executados sozinhos.</p><p>Vídeo: <a href="https://youtu.be/1pUC_Z9rYiI">https://youtu.be/1pUC_Z9rYiI</a></p><p>Todo teste começa digitando “buy some cheese” e alguns outros itens, assim como um usuário que é amante de de queijo faria.</p><h3>Exemplo de itens concluídos</h3><p>Agora, vamos testar a funcionalidade da aplicação de “marcar todos os itens como concluídos”. O usuário pode clicar em um elemento em nossa aplicação com um <em>markup</em> para marcar todos os itens atuais como concluídos.</p><pre>&lt;input<br>className=&#39;toggle-all&#39;<br>type=&#39;checkbox&#39;<br>onChange={this.toggleAll}<br>checked={activeTodoCount === 0} /&gt;<br>Aqui está a pergunta de um milhão de dólares - como inserimos itens de tarefas antes de clicar em .toggle-all? Poderíamos escrever e usar um comando customizado como cy.createDefaultTodos().as(&#39;todos&#39;) para percorrer a interface de usuário da página, basicamente manipulando a página para criar itens.<br>// cypress/support/commands.js<br>const TODO_ITEM_ONE = &#39;buy some cheese&#39;<br>const TODO_ITEM_TWO = &#39;feed the cat&#39;<br>const TODO_ITEM_THREE = &#39;book a doctors appointment&#39;<br>Cypress.Commands.add(&#39;createDefaultTodos&#39;, function () {<br>cy.get(&#39;.new-todo&#39;)<br>.type(`${TODO_ITEM_ONE}{enter}`)<br>.type(`${TODO_ITEM_TWO}{enter}`)<br>.type(`${TODO_ITEM_THREE}{enter}`)<br>.get(&#39;.todo-list li&#39;)<br>})</pre><p>Criaremos esse novo comando customizados createDefaultTodos antes de cada teste no bloco beforeEach.</p><pre>// cypress/integration/spec.js<br>context(&#39;Mark all as completed&#39;, function () {<br>beforeEach(function () {<br>cy.createDefaultTodos().as(&#39;todos&#39;)<br>})<br>it(&#39;should allow me to mark all items as completed&#39;, function () {<br>// complete all todos<br>// we use &#39;check&#39; instead of &#39;click&#39;<br>// because that indicates our intention much clearer<br>cy.get(&#39;.toggle-all&#39;).check()<br>// get each todo li and ensure its class is &#39;completed&#39;<br>cy.get(&#39;@todos&#39;).eq(0).should(&#39;have.class&#39;, &#39;completed&#39;)<br>cy.get(&#39;@todos&#39;).eq(1).should(&#39;have.class&#39;, &#39;completed&#39;)<br>cy.get(&#39;@todos&#39;).eq(2).should(&#39;have.class&#39;, &#39;completed&#39;)<br>})<br>// more tests<br>// - should allow me to clear the complete state of all items<br>// - complete all checkbox should update state when items are completed / cleared<br>})</pre><p>Aqui está o primeiro teste por si só</p><p><a href="https://cypress-io.ghost.io/blog/content/images/2019/05/completed.gif">https://cypress-io.ghost.io/blog/content/images/2019/05/completed.gif</a></p><p>Mas considere duas coisas:</p><ol><li>Estamos sempre inserindo os itens pela interface do usuário — repetindo o que todo teste no contexto “New Todo” já fez.</li><li>A maior parte do tempo de execução do teste foi ocupada pela inserção dos itens e não por marcar o item como completo.</li></ol><p>O último ponto é importante — nossos testes são lentos devido a inserção de 3 itens pela interface do usuário antes de cada teste. Os três testes no contexto acima “Mark all as completed” geralmente levam de 4 a 5 segundos.</p><h3>Application actions</h3><p>Código Fonte</p><p>Você pode encontrar o código fonte final deste blog post no passo-a-passo das <a href="https://github.com/cypress-io/cypress-example-recipes#application-actions">App Actions</a>. Você também pode ver os mesmos testes implementados em estilos diferentes, incluindo Page Object e App Actions no repositório<a href="https://github.com/bahmutov/test-todomvc-using-app-actions"> bahmutov/test-todomvc-using-app-actions</a>.</p><p>Imagine que, em vez de sempre inserir novos itens por meio da interface do usuário, possamos definir o estado do aplicativo diretamente por nosso teste. Como a arquitetura do Cypress permite interagir com o aplicativo em teste, isso é simples. Tudo o que precisamos fazer é expor uma referência ao objeto de modelo da aplicação, anexando-o ao objeto window, por exemplo.</p><pre>// app.jsx code<br>var model = new app.TodoModel(&#39;react-todos&#39;);<br>if (window.Cypress) {<br>window.model = model<br>}</pre><p>Definir um <strong>modelo </strong>de referência como uma propriedade do objeto window da aplicação fornece aos nossos testes uma maneira fácil de chamar um método model.addTodo que já existe em js/todoModel.js</p><pre>// js/todoModel.js<br>// Modelo: mantém todos os &quot;todos&quot; e tem métodos para agir sobre eles<br>app.TodoModel = function(key) {<br>this.key = key<br>this.todos = Utils.store(key)<br>this.onChanges = []<br>}<br>app.TodoModel.prototype.addTodo = function(title) {<br>this.todos = this.todos.concat({<br>id: Utils.uuid(),<br>title: title,<br>completed: false<br>});<br>this.inform();<br>};<br>app.TodoModel.prototype.inform = …<br>app.TodoModel.prototype.toggleAll = …<br>// outros métodos</pre><p>Em vez de usar um comando cutomizado do Page Object o para criar todos como cy.createDefaultTodos().as(‘todos’), podemos usar model.addTodo para adicionar itens diretamente usando a “API” interna da aplicação. No código abaixo, estou usando cy.window () para acessar o object window da aplicação, e seu modelo de propriedade, em seguida, .invoke() para chamar o método addTodo na instância do modelo.</p><pre>beforeEach(function() {<br>cy.window().its(&#39;model&#39;).invoke(&#39;addTodo&#39;, TODO_ITEM_ONE)<br>cy.window().its(&#39;model&#39;).invoke(&#39;addTodo&#39;, TODO_ITEM_TWO)<br>cy.window().its(&#39;model&#39;).invoke(&#39;addTodo&#39;, TODO_ITEM_THREE)<br>cy.get(&#39;.todo-list li&#39;).as(&#39;todos&#39;)<br>})</pre><p>Com a configuração acima, nossos testes estão sendo executados muito mais rápido — os três terminam em pouco mais de 1 segundo, já três vezes mais rápido do que antes. Mas mesmo o código acima é mais lento que o necessário — porque estamos usando vários comandos do Cypress para adicionar cada item, o que gera sobrecarga. Em vez disso, podemos alterar o TodoModel.prototype.addTodo para aceitar vários itens de uma só vez.</p><pre>// js/todoModel.js<br>app.TodoModel.prototype.addTodo = function(…titles) {<br>titles.forEach(title =&gt; {<br>this.todos = this.todos.concat({<br>id: Utils.uuid(),<br>title: title,<br>completed: false<br>});<br>})<br>this.inform();<br>};<br>// cypress/integration/spec.js<br>beforeEach(function () {<br>cy.window().its(&#39;model&#39;).invoke(&#39;addTodo&#39;,<br>TODO_ITEM_ONE, TODO_ITEM_TWO, TODO_ITEM_THREE)<br>cy.get(&#39;.todo-list li&#39;).as(&#39;todos&#39;)<br>})</pre><p><a href="https://cypress-io.ghost.io/blog/content/images/2019/05/use-action.gif">https://cypress-io.ghost.io/blog/content/images/2019/05/use-action.gif</a></p><p>Você percebeu o que fizemos para melhorar nosso teste? NÃO alteramos o código de teste, mas melhoramos o código da aplicação. Ao usar as ações internas da aplicação em nossos testes de ponta a ponta, podemos melhorar a aplicação enquanto escrevemos nossos testes! Nosso esforço leva diretamente a esclarecer o modelo de interface, tornando-o mais testável, melhor documentado e facilitando o uso de outro código da aplicação.</p><p><strong>Você também pode invocar app action da aplicação no console do DevTools diretamente, alternando o contexto para “Your app”, veja a captura de tela abaixo.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*DB-B1W1d2XC9Xwqw" /></figure><h3>Apenas funções</h3><p>Podemos mover a lógica de app action para comandos customizados, substituindo o uso da interface do usuário para manipular o estado pela interface do modelo interno da aplicação que está chamando. Mas prefiro criar pequenas funções reutilizáveis, em vez de anexar métodos adicionais ao objeto cy.</p><pre>const addDefaultTodos = () =&gt; {<br>cy.window().its(&#39;model&#39;).invoke(&#39;addTodo&#39;,<br>TODO_ITEM_ONE, TODO_ITEM_TWO, TODO_ITEM_THREE)<br>cy.get(&#39;.todo-list li&#39;).as(&#39;todos&#39;)<br>}<br>beforeEach(addDefaultTodos)</pre><p>Como o Cypress vem com um <em>bundler</em> incluído, podemos mover addDefaultTodos para um arquivo separado com utilitários e usar diretivas de solicitação ou importação para usá-lo a partir do arquivo de especificação (o arquivo de testes). E podemos documentar addDefaultTodos usando a convenção JSDoc para obter uma bela funcionalidade de autocomplete em nossos arquivos de teste.</p><pre>// utils.js<br>const TODO_ITEM_ONE = &#39;buy some cheese&#39;<br>const TODO_ITEM_TWO = &#39;feed the cat&#39;<br>const TODO_ITEM_THREE = &#39;book a doctors appointment&#39;<br>/**<br>* Creates default todo items using application action.<br>* @example<br>* import { addDefaultTodos } from &#39;./utils&#39;<br>* beforeEach(addDefaultTodos)<br>*/<br>export const addDefaultTodos = () =&gt; {<br>cy.window().its(&#39;model&#39;).invoke(&#39;addTodo&#39;,<br>TODO_ITEM_ONE, TODO_ITEM_TWO, TODO_ITEM_THREE)<br>cy.get(&#39;.todo-list li&#39;).as(&#39;todos&#39;)<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*hrL7DUo7k7qButNZ" /></figure><p>Usar <em>app action</em> é apenas o uso de funções JavaScript, e o uso de funções é simples.</p><h3>Exemplo de persistência</h3><p>Há outro exemplo nos testes da aplicação TodoMVC que mostra o poder de definir o estado e as ações iniciais. O teste de persistência adiciona dois itens, clica em um deles e recarrega a página. Os dois itens devem estar lá e o estado concluído deve ser preservado. O teste original no Cypress faz tudo através da interface do usuário.</p><pre>context(&#39;Persistence&#39;, function() {<br>it(&#39;should persist its data&#39;, function() {<br>// mimicking TodoMVC tests<br>// by writing out this function<br>function testState() {<br>cy.get(&#39;@firstTodo&#39;).should(&#39;contain&#39;, TODO_ITEM_ONE)<br>.and(&#39;have.class&#39;, &#39;completed&#39;)<br>cy.get(&#39;@secondTodo&#39;).should(&#39;contain&#39;, TODO_ITEM_TWO)<br>.and(&#39;not.have.class&#39;, &#39;completed&#39;)<br>}<br>cy.createTodo(TODO_ITEM_ONE).as(&#39;firstTodo&#39;)<br>cy.createTodo(TODO_ITEM_TWO).as(&#39;secondTodo&#39;)<br>cy.get(&#39;@firstTodo&#39;).find(&#39;.toggle&#39;).check()<br>.then(testState)<br>.reload()<br>.then(testState)<br>})<br>})</pre><p>A função auxiliar testState verifica os dois itens — o primeiro deve ser concluído e o segundo não. Verificamos antes de recarregar a página e depois.</p><p>Mas por que estamos criando itens e por que estamos clicando nos primeiros itens para marcá-los como completos? Nós sabemos que funciona! Temos outro teste acima que já testou a interface do usuário para concluir um item. Esse teste foi chamado de item — deve permitir que eu marque os itens como concluídos e parece quase exatamente o mesmo:</p><pre>context(&#39;Item&#39;, function() {<br>it(&#39;should allow me to mark items as complete&#39;, function() {<br>cy.createTodo(TODO_ITEM_ONE).as(&#39;firstTodo&#39;)<br>cy.createTodo(TODO_ITEM_TWO).as(&#39;secondTodo&#39;)<br>cy.get(&#39;@firstTodo&#39;).find(&#39;.toggle&#39;).check()<br>cy.get(&#39;@firstTodo&#39;).should(&#39;have.class&#39;, &#39;completed&#39;)<br>cy.get(&#39;@secondTodo&#39;).should(&#39;not.have.class&#39;, &#39;completed&#39;)<br>cy.get(&#39;@secondTodo&#39;).find(&#39;.toggle&#39;).check()<br>cy.get(&#39;@firstTodo&#39;).should(&#39;have.class&#39;, &#39;completed&#39;)<br>cy.get(&#39;@secondTodo&#39;).should(&#39;have.class&#39;, &#39;completed&#39;)<br>})<br>})</pre><p>NÃO devemos repetir os testes para as mesmas ações da interface do usuário. NÃO devemos repetir as interações da interface do usuário, mesmo que sigamos as práticas recomendadas e testemos os recursos, e não a implementação, usando IDs de teste e uma boa biblioteca auxiliar, como a Cypress-Testing-Library — ela ainda está vinculando nossos testes à estrutura da página a qual pode mudar.</p><p>Aqui está a manipulação original do aplicativo usando a interface do usuário.</p><pre>cy.createTodo(TODO_ITEM_ONE).as(&#39;firstTodo&#39;)<br>cy.createTodo(TODO_ITEM_TWO).as(&#39;secondTodo&#39;)<br>cy.get(&#39;@firstTodo&#39;).find(&#39;.toggle&#39;).check()</pre><p>E aqui está como podemos refazer isso para usar app action (<em>application actions</em>). Primeiro, podemos usar nossa função de utilitário addTodo para controlar a aplicação e ainda usar a caixa de seleção class = “toggle” para alternar o primeiro item como concluído.</p><pre>// spec.js<br>import { addTodos } from &#39;./utils&#39;;<br>addTodos(TODO_ITEM_ONE, TODO_ITEM_TWO)<br>cy.get(&#39;.todo-list li&#39;).eq(0).find(&#39;.toggle&#39;).check()</pre><p>Em seguida, podemos ver os métodos de modelo no todoModel.js para ver como podemos alternar diretamente um item de tarefa.</p><pre>app.TodoModel.prototype.toggle = function(todoToToggle) {<br>this.todos = this.todos.map(function(todo) {<br>return todo !== todoToToggle ?<br>todo :<br>Utils.extend({}, todo, { completed: !todo.completed });<br>});<br>this.inform();<br>};</pre><p>Podemos usar o método model.toggle para alternar o sinalizador concluído? O Cypress pode fazer tudo o que você pode fazer no DevTools. Então, novamente, podemos abrir o DevTools a partir do executor de teste, alternar para o contexto “Your App” e tentar. Observe como, após o término do teste, chamei model.toggle (model.todos [0]) e o primeiro item do aplicativo voltou a ficar incompleto.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*70uIf4l6PN83RgNK" /></figure><p>Vamos escrever uma função utilitária para chamar a alternância da <em>application action</em>. Para nossos testes, provavelmente queremos alternar um item não por referência, mas por índice.</p><pre>/**<br>* Toggle given todo item. Returns chain so you can attach more Cypress commands<br>* @param {number} k index of the todo item to toggle, 0 - first item<br>* @example<br>import { addTodos, toggle } from &#39;./utils&#39;<br>it(&#39;completes an item&#39;, () =&gt; {<br>addTodos(&#39;first&#39;)<br>toggle(0)<br>})<br>*/<br>export const toggle = (k = 0) =&gt;<br>cy.window().its(&#39;model&#39;)<br>.then(model =&gt; {<br>expect(k, &#39;check item index&#39;).to.be.lessThan(model.todos.length)<br>model.toggle(model.todos[k])<br>})</pre><p>Como alternativa, poderíamos ter alterado a função de alternância do modelo do aplicativo para usar um índice como argumento. Veja como o código de teste agora é um “cliente” do código da aplicação e pode influenciar a arquitetura e o design da aplicação?</p><p>Nosso teste alterado cria os itens e alterna o primeiro e é executado rapidamente.</p><pre>context(&#39;Persistence&#39;, function() {<br>// mimicking TodoMVC tests<br>// by writing out this function<br>function testState() {<br>cy.get(&#39;.todo-list li&#39;).eq(0)<br>.should(&#39;contain&#39;, TODO_ITEM_ONE).and(&#39;have.class&#39;, &#39;completed&#39;)<br>cy.get(&#39;.todo-list li&#39;).eq(1)<br>.should(&#39;contain&#39;, TODO_ITEM_TWO).and(&#39;not.have.class&#39;, &#39;completed&#39;)<br>}<br>it(&#39;should persist its data&#39;, function() {<br>addTodos(TODO_ITEM_ONE, TODO_ITEM_TWO)<br>.toggle(0)<br>.then(testState)<br>.reload()<br>.then(testState)<br>})<br>})<br>Agora eu posso passar por outros testes e substituir todos os cy.get(&#39;.todo-list li&#39;).eq(k).find(&#39;. toggle&#39;).check() por toggle(k). Mais rápido e comprovado que funciona.<br>Da mesma forma, podemos atualizar os testes ponta-a-ponta de roteamento para NÃO passar pelos elementos da interface do usuário ao configurar a página, em vez de usar app action. Ao mesmo tempo, deixamos de clicar nos links reais que estamos testando - o teste está afirmando que o link da interface do usuário com o texto &quot;Active&quot; funciona!<br>context(&#39;Routing&#39;, function() {<br>beforeEach(addDefaultTodos) // app action<br>it(&#39;should allow me to display active items&#39;, function() {<br>toggle(1) // app action<br>// the UI feature we are actually testing - the &quot;Active&quot; link<br>cy.get(&#39;.filters&#39;).contains(&#39;Active&#39;).click()<br>cy.get(&#39;@todos&#39;).eq(0).should(&#39;contain&#39;, TODO_ITEM_ONE)<br>cy.get(&#39;@todos&#39;).eq(1).should(&#39;contain&#39;, TODO_ITEM_THREE)<br>})<br>// more tests<br>})</pre><p>Observe que sempre que você escrever uma função de teste utilitária um pouco mais longa, como alternar, é um bom indicador de que talvez a interface interna do aplicativo precise ser alterada em vez de escrever mais código de teste!</p><pre>// hmm, maybe we need to add a `model.toggleIndex()` method?<br>export const toggle = (k = 0) =&gt;<br>cy.window().its(&#39;model&#39;)<br>.then(model =&gt; {<br>expect(k, &#39;check item index&#39;).to.be.lessThan(model.todos.length)<br>model.toggle(model.todos[k])<br>})</pre><p>Se adicionarmos um método model.toggleIndex à aplicação,</p><p>a mesma se tornará mais testável e talvez ainda mais fácil de desenvolver no futuro. O código de teste também será simplificado.</p><h3>DRY test code</h3><p>Cada bloco de testes é realmente apenas um <em>clausure</em>. Podemos usar isso para nossa vantagem com app actions. Os seletores do elemento passados ​​para um bloco de teste serão localizados neste bloco. Isso naturalmente mantém os seletores locais para cada <em>clausure</em>. Todos os blocos de teste a seguir podem usar <em>app actions</em> e não precisam saber sobre o seletor. No exemplo abaixo, observe os seletores NEW_TODO e TOGGLE_ALL.</p><pre>describe(&#39;TodoMVC&#39;, function() {<br>// entrada do item de teste<br>context(&#39;New Todo&#39;, function() {<br>// O seletor para inserir o novo item de tarefa é privado para esses testes<br>const NEW_TODO = &#39;.new-todo&#39;<br>it(&#39;should allow me to add todo items&#39;, function() {<br>cy.get(NEW_TODO)<br>.type(TODO_ITEM_ONE)<br>.type(&#39;{enter}&#39;)<br>// mais comandos<br>})<br>// mais testes que usam o seletor NEW_TODO<br>})<br>// teste de alternância de todos os itens<br>context(&#39;Mark all as completed&#39;, function() {<br>// O seletor para alternar todos os itens é privado para esses testes<br>const TOGGLE_ALL = &#39;.toggle-all&#39;<br>beforeEach(addDefaultTodos)<br>it(&#39;should allow me to mark all items as completed&#39;, function() {<br>cy.get(TOGGLE_ALL).check()<br>// mais comandos<br>})<br>// mais testes que usam o seletor TOGGLE_ALL<br>})<br>})</pre><p>Os testes acima mostram como cada seletor é privado para o bloco específico de testes. Por exemplo, o seletor const NEW_TODO = ‘.new-todo’ é privado para o bloco de testes “New Todo” e o seletor const TOGGLE_ALL = ‘.toggle-all’ é privado para o bloco de testes “Mark all as completed” . Outros testes não precisam conhecer os seletores para os elementos da página para adicionar itens ou marcar todos os concluídos — os testes podem usar app action.</p><p>Mas, em algumas situações, você pode querer compartilhar um seletor. Por exemplo, muitos testes de vários blocos podem precisar pegar todos os itens Todo na página e não há como fugir disso. Ainda podemos manter o seletor nos testes sem criar page objects como uma variável local ALL_ITEMS.</p><pre>describe(&#39;TodoMVC&#39;, function() {<br>// common selector used across many tests<br>const ALL_ITEMS = &#39;.todo-list li&#39;<br>context(&#39;New Todo&#39;, function() {<br>const NEW_TODO = &#39;.new-todo&#39;<br>it(&#39;should allow me to add todo items&#39;, function() {<br>cy.get(NEW_TODO)<br>.type(TODO_ITEM_ONE)<br>.type(&#39;{enter}&#39;)<br>cy.get(ALL_ITEMS)<br>.eq(0)<br>.find(&#39;label&#39;)<br>.should(&#39;contain&#39;, TODO_ITEM_ONE)<br>})<br>// more tests<br>})<br>context(&#39;Mark all as completed&#39;, function() {<br>const TOGGLE_ALL = &#39;.toggle-all&#39;<br>beforeEach(addDefaultTodos)<br>it(&#39;should allow me to mark all items as completed&#39;, function() {<br>cy.get(TOGGLE_ALL).check()<br>cy.get(ALL_ITEMS)<br>.eq(0)<br>.should(&#39;have.class&#39;, &#39;completed&#39;)<br>})<br>// more tests<br>})<br>})</pre><p>No exemplo acima, estamos usando o seletor const ALL_ITEMS = ‘.todo-list li’ em vários testes. Eu até prefiro criar uma função utilitária local allItems para retornar todos os itens da lista em vez de compartilhar uma constante do seletor.</p><pre>describe(&#39;TodoMVC&#39;, function() {<br>const ALL_ITEMS = &#39;.todo-list li&#39;<br>/**<br>* Returns all todo items<br>*/<br>const allItems = () =&gt; cy.get(ALL_ITEMS)<br>context(&#39;New Todo&#39;, function() {<br>const NEW_TODO = &#39;.new-todo&#39;<br>it(&#39;should allow me to add todo items&#39;, function() {<br>cy.get(NEW_TODO)<br>.type(TODO_ITEM_ONE)<br>.type(&#39;{enter}&#39;)<br>allItems()<br>.eq(0)<br>.find(&#39;label&#39;)<br>.should(&#39;contain&#39;, TODO_ITEM_ONE)<br>})<br>// more tests<br>})<br>context(&#39;Mark all as completed&#39;, function() {<br>const TOGGLE_ALL = &#39;.toggle-all&#39;<br>beforeEach(addDefaultTodos)<br>it(&#39;should allow me to mark all items as completed&#39;, function() {<br>cy.get(TOGGLE_ALL).check()<br>allItems()<br>.eq(0)<br>.should(&#39;have.class&#39;, &#39;completed&#39;)<br>})<br>// more tests<br>})<br>})</pre><p>À medida que o número de testes aumenta, podemos naturalmente dividir nosso único arquivo de <em>espc</em> em vários arquivos de <em>espc</em>. Isso permitiria ao nosso servidor de integração contínua executar todos os testes em paralelo. Nesse caso, podemos querer mover a função utilitária allItems e o seletor ALL_ITEMS para um arquivo utilitário comum e importar allItems de todas as specs necessárias.</p><pre>// cypress/integration/utils.js<br>const ALL_ITEMS = &#39;.todo-list li&#39;<br>/**<br>* Retornar todo items<br>* @example<br>import {allItems} from &#39;./utils&#39;<br>allItems().should(&#39;not.exist&#39;)<br>*/<br>export const allItems = () =&gt; cy.get(ALL_ITEMS)<br>// cypress/integration/spec.js<br>import {<br>allItems<br>} from &#39;./utils&#39;<br>describe(&#39;TodoMVC&#39;, function() {<br>context(&#39;New Todo&#39;, function() {<br>const NEW_TODO = &#39;.new-todo&#39;<br>it(&#39;should allow me to add todo items&#39;, function() {<br>cy.get(NEW_TODO)<br>.type(TODO_ITEM_ONE)<br>.type(&#39;{enter}&#39;)<br>allItems()<br>.eq(0)<br>.find(&#39;label&#39;)<br>.should(&#39;contain&#39;, TODO_ITEM_ONE)<br>})<br>// more tests<br>})<br>context(&#39;Mark all as completed&#39;, function() {<br>const TOGGLE_ALL = &#39;.toggle-all&#39;<br>beforeEach(addDefaultTodos)<br>it(&#39;should allow me to mark all items as completed&#39;, function() {<br>cy.get(TOGGLE_ALL).check()<br>allItems()<br>.eq(0)<br>.should(&#39;have.class&#39;, &#39;completed&#39;)<br>})<br>// more tests<br>})<br>})</pre><p>O objetivo é tornar os testes fáceis de ler, simples de entender e seguros de mudar quando necessário.</p><h3>Foco no erro</h3><p>Um belo benefício do uso de app actions para conduzir testes são o foco nos erros. Por exemplo, a interface de usuário da aplicação possui uma caixa de seleção para alternar todos os itens como concluídos. O código fica assim.</p><pre>if (todos.length) {<br>main = (<br>&lt;section className=&#39;main&#39;&gt;<br>&lt;input className=&#39;toggle-all&#39;<br>type=&#39;checkbox&#39;<br>onChange={this.toggleAll}<br>checked={activeTodoCount === 0}<br>/&gt;<br>&lt;ul className=&#39;todo-list&#39;&gt;{todoItems}&lt;/ul&gt;<br>&lt;/section&gt;<br>)<br>}</pre><p>Se eu remover o elemento &lt;input className = ‘toggle-all’ … /&gt;, apenas os testes dentro do bloco “Mark all as completed quebram.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*Vpbe7yfDqY48NjdB" /></figure><p>Nenhum outro teste está passando por esse elemento da interface de usuário, portanto, nenhum outro teste quebra.</p><p>Da mesma forma, cada item Todo renderiza uma caixa de seleção para marcar seu próprio item como concluído. O código fica assim.</p><pre>&lt;input<br>className=&quot;toggle&quot;<br>type = &quot;checkbox&quot;<br>checked = {this.props.todo.completed}<br>onChange = {this.props.onToggle}<br>/&gt;<br>Se eu comentar a linha onChange = {this.props.onToggle} assim.<br>&lt; input<br>className = &#39;toggle&#39;<br>type = &#39;checkbox&#39;<br>checked = {this.props.todo.completed}<br>// onChange={this.props.onToggle}<br>/&gt;</pre><p>Somente os testes para concluir os itens individuais quebram.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*aPAihnd6gv13act9" /></figure><p>Estou realmente feliz por ter um recurso de página afetando apenas um único conjunto de testes. Esta é uma mudança bem-vinda do típico “alguma coisa pequena da interface do usuário mudou — metade dos testes de ponta-a-ponta estao vermelhos agora”.</p><p>Se usarmos TypeScript para escrever nosso aplicativo, nossos testes poderão até usar a definição do modelo de interface da aplicação para chamar corretamente os métodos existentes. Isso aceleraria a refatoração, porque as definições de tipo permitiriam refatorar imediatamente todos os locais onde o código de teste está chamando no código do aplicação.</p><h3>Limitações do App action</h3><h3>Chamando muitas ações muito rapidamente</h3><p>Ao usar App action para executar várias operações, seus testes podem ser executados antes do aplicativo. Por exemplo, se a aplicação salvar todos os todos no servidor antes de armazená-los localmente, você não poderá marcá-los imediatamente como concluídos.</p><pre>// model<br>app.TodoModel.prototype.addTodo = function(…todos) {<br>// make XHR to the server to save todos<br>ajax({<br>method: &#39;POST&#39;,<br>url: &#39;/todos&#39;,<br>data: todos<br>}).then(() =&gt;<br>// then update local state<br>this.saveTodos(todos)<br>).then(() =&gt;<br>// this triggers DOM render<br>this.inform()<br>)<br>}<br>// spec.js<br>it(&#39;completes all items&#39;, () =&gt; {<br>addDefaultTodos()<br>toggle(1) // marks item completed<br>// click on &quot;Completed&quot; link<br>// assert there is 1 completed item<br>})</pre><p>O teste acima conclui todos os itens, e provavelmente às vezes passará, e as vezes falhará. E é tudo porque o teste é executado mais rapidamente do que o aplicativo pode lidar com ações.</p><p>Por exemplo, enquanto a aplicação ainda está adicionando novos todos dentro do método addTodo, o teste já está enviando uma ação de alternância que tentará concluir o item todo com o índice 1. Talvez a aplicação tenha tido tempo suficiente para enviar a lista original de todos para o servidor e definí-los no estado local — nesse caso, o teste íra passar. Mas, na maioria das vezes, a aplicação ainda está aguardando a resposta do servidor — nesse caso, a lista local de itens ainda está vazia e tentar alternar o item com o índice 1 acionará um erro.</p><p>Ao usar app action para guiar a aplicação, nos afastamos da maneira como um usuário usaria nossa aplicação. Os usuários não poderiam alternar um item antes que um item seja mostrado ao usuário na página. Portanto, nossos testes precisam esperar que os itens apareçam na interface de usuário antes de executar a toggle(1). Novamente, uma simples função reutilizável deve ser suficiente.</p><pre>it(&#39;completes all items&#39;, () =&gt; {<br>addDefaultTodos()<br>allItems().should(&#39;have.length&#39;, 3)<br>toggle(1) // marks item completed<br>// click on &quot;Completed&quot; link<br>// assert there is 1 completed item<br>})</pre><p>Eu recomendo o padrão mostrado acima — execute uma ação na aplicação, aguarde a atualização da interface do usuário para o estado desejado escrevendo uma asserção, execute outra ação na aplicação e aguarde novamente a atualização da interface do usuário. Isso é executado o mais rápido possível, pois o Cypress pode observar diretamente o DOM e continuar com a próxima ação assim que a afirmação passar.</p><p>Você não está restrito a observar o DOM — você também pode espionar facilmente as chamadas de rede. Por exemplo, podemos espionar a chamada XHR POST / todos do aplicativo para o servidor e aguardar a chamada de rede antes de executar a alternância de toggle (1).</p><pre>it(&#39;completes all items&#39;, () =&gt; {<br>cy.server()<br>cy.route(&#39;POST&#39;, &#39;/todos&#39;).as(&#39;save&#39;)<br>addDefaultTodos()<br>cy.wait(&#39;@save&#39;) // waits for XHR POST /todos before test continues<br>toggle(1) // marks item completed<br>// click on &quot;Completed&quot; link<br>// assert there is 1 completed item<br>})</pre><p>Ainda melhor — podemos espionar métodos diretamente em nossa aplicação! Como nosso aplicativo chama model.inform quando termina de atualizar o estado, é um bom sinal de que podemos chamar outra app action.</p><pre>it(&#39;completes all items&#39;, () =&gt; {<br>cy.window()<br>.its(&#39;model&#39;)<br>.then(model =&gt; {<br>cy.spy(model, &#39;inform&#39;).as(&#39;inform&#39;)<br>})<br>addDefaultTodos()<br>// wait until the spy is called once<br>cy.get(&#39;@inform&#39;).should(&#39;have.been.calledOnce&#39;)<br>toggle(1) // marks item completed<br>// click on &quot;Completed&quot; link<br>// assert there is 1 completed item<br>})</pre><p>A interface de usuário do Cypress mostra informações sobre cada método que estamos espionando no log de comandos.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*_z_nJuMkyEWVNnPt" /></figure><p>Para resumir: as app action podem ser chamado a partir do teste mais rapidamente do que o aplicativo pode processá-las. Nesse caso, você pode interpretar os testes como flaky devido à recorrência entre o teste e o aplicaçao. Felizmente, você pode sincronizar o teste e a aplicação de várias maneiras. O teste pode:</p><ol><li>Aguardar que DOM seja atualizado conforme o esperado.</li><li>Observar o tráfego da rede e aguardar uma chamada XHR esperada.</li><li>Espionar um método no aplicativo e continuar quando for chamado.</li></ol><h3>Ações restritas</h3><p>Às vezes, o código da aplicacao não consegue realizar a ação desejada. Por exemplo no <a href="https://www.youtube.com/watch?v=5XQOK0v_YRE">Cypress Best Practices</a> fala, Brian Mann argumentou que:</p><ul><li>Ao testar uma página de login, os testes ponta a ponta devem usar a IU, assim como o usuário faz</li><li>Ao testar qualquer outro fluxo de usuário que requer um login, o teste deve executar o login diretamente (por exemplo, usando o comando <a href="https://on.cypress.io/request">cy.request()</a>) e não passar pela IU repetidamente.</li></ul><p>Na implementação acima, o código do aplicativo não pode fazer o login usando o mesmo método que o cy.request. Portanto, os testes de ponta a ponta devem chamar cy.request () e não invocar uma app action. Isso ainda evita o uso do padrão page object — um comando customizado ou uma função simples é suficiente para alcançá-lo.</p><h3>Pensamentos finais</h3><p>Mudar de page objects que sempre passam pela interface do usuário da página para app action que controlam o aplicativo por meio de sua API de modelo interno traz muitos benefícios.</p><ul><li>Os testes se tornam muito mais rápidos. Até os testes simples de TodoMVC, executados localmente no navegador Electron do Cypress, passaram de 34 segundos para 17 segundos depois de passar da interface do usuário para o uso de app action — umaumento na velocidade de 50%.</li><li>Os testes agora influenciam e se beneficiam da refatoração do código da aplicação. Quanto mais sensata e melhor documentada a interface interna da aplicação se tornar, mais fácil será escrever testes de ponta-a-ponta para eles.</li><li>Você evita escrever uma camada de código separada de baixo acoplamento sobre interfaces de usuário efêmeras e instáveis. Em vez disso, os testes usam e estão vinculados à modelos de interface da aplicação interna mais duradouros.</li></ul><p>De fato, as funções utilitárias que eu tinha que escrever apenas mapeando os testes de sintaxe para as app action, e a maioria são apenas de sintaxe sem estado, como syntax sugar.</p><p>In fact, the utility functions I had to write only map test syntax to app action, and the majority are just stateless syntax sugar like.</p><pre>export const addTodos = (…todos) =&gt; {<br>cy.window().its(&#39;model&#39;).invoke(&#39;addTodo&#39;, …todos)<br>}</pre><p>Não há estado paralelo (dentro dos page objects), nem lógica de teste condicional — apenas invocacao direta do código da aplicação, como você pode fazer no console do DevTools.</p><h3>Mais Informações</h3><p>Você pode encontrar o código fonte para esta postagem sobre <a href="https://github.com/cypress-io/cypress-example-recipes#application-actions">App Action</a>. Você também pode ver os mesmos testes implementados em estilos diferentes, incluindo Page Object e App Action no repositório <a href="https://github.com/bahmutov/test-todomvc-using-app-actions">bahmutov/test-todomvc-using-app-actions</a>.</p><p>Você pode usar a mesma idéia de App Action para controlar qualquer aplicação de testes. Em outros posts, eu já mostrei como:</p><ul><li><a href="https://cypress-io.ghost.io/blog/2018/11/14/testing-redux-store/">Dispatch Redux actions</a> e até compartilhar código entre testes e aplicação</li><li><a href="https://cypress-io.ghost.io/blog/2017/11/28/testing-vue-web-application-with-vuex-data-store-and-rest-backend/">Dispatch Vuex actions</a> e verifique as atualizações do DOM e as requisições de rede.</li></ul><p>Os exemplos acima e as postagens do blog me ajudaram a ver as deficiências do Page Object e os benefícios das App Action em testes de ponta-a-ponta.</p><p>Dicionário:</p><ul><li>Application actions:</li><li>Linters: são máquinas de remover fibras do algodão, mas na programação são ferramentas que analisam a base de código em busca de erros, originalmente usados na linguagem C.</li><li>Teste ponta a ponta: o teste ponta a ponta é um forma de realizar testes na qual visa verificar o sistema de uma forma mais completa simulando o ambiente real.</li><li>B<em>undler:</em> é uma ferramenta que permite que a função require funcione no navegador.</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=dd6ca931ecf6" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Por que o “Application Actions” é melhor do que o “Page Object” nos testes automatizados]]></title>
            <link>https://medium.com/@jonasdaviladasilva/por-que-o-application-actions-%C3%A9-melhor-do-que-o-page-object-nos-testes-automatizados-1987fdd6857b?source=rss-4fdb4b1bb5c8------2</link>
            <guid isPermaLink="false">https://medium.com/p/1987fdd6857b</guid>
            <dc:creator><![CDATA[Jonas Davila]]></dc:creator>
            <pubDate>Wed, 15 Nov 2023 22:04:46 GMT</pubDate>
            <atom:updated>2023-11-15T23:29:35.870Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aBSOGnB2R51VNFHlEPNgwA.jpeg" /></figure><p>Os testes automatizados desempenham um papel crucial no desenvolvimento de software, garantindo a qualidade e a estabilidade de um aplicativo. Ao longo dos anos, surgiram várias abordagens e práticas para escrever testes automatizados eficazes. Uma dessas práticas é o uso de Page Object, que são amplamente utilizados para tornar os testes End-to-end legíveis e fáceis de manter. No entanto, há uma crescente controvérsia sobre a eficácia dos Page Object e se eles são realmente a melhor abordagem para testes automatizados. Neste artigo, discutiremos por que as Application Actions são melhores do que os Page Object e como elas podem melhorar a produtividade e a eficiência dos testes automatizados.</p><p><strong>Sumário:</strong></p><p>1.Problemas com os Page Object</p><p>2. Benefícios das Application Actions</p><p>3. Exemplos de uso de Application Actions no Cypress</p><p>4. Conclusão</p><p><strong>1. Problemas com os Page Object:</strong></p><p>Embora os Page Object tenham sido amplamente adotados como uma prática recomendada para testes automatizados, eles têm algumas desvantagens significativas. Um dos principais problemas é a manutenção. Os Page Object centralizam os seletores de Elementos da página em um só lugar, o que pode parecer uma vantagem inicialmente. No entanto, à medida que o aplicativo evolui e as alterações são feitas nas páginas, os Page Object precisam ser atualizados constantemente, o que pode se tornar uma tarefa tediosa e propensa a erros.</p><p>Outro problema dos Page Object é que eles introduzem estado adicional nos testes. Os testes automatizados devem ser independentes e isolados, mas os Page Object podem criar dependências entre os testes, pois o estado dos elementos da página é compartilhado entre eles. Isso pode levar a resultados inconsistentes e dificultar a depuração de falhas nos testes.</p><p>Além disso, os Page Object podem tornar os testes lentos. Como os testes interagem com os elementos da página por meio dos Page Object, cada ação requer uma busca e manipulação desses elementos. Isso pode resultar em um tempo de execução mais longo, especialmente em testes que envolvem várias ações em diferentes páginas.</p><p><strong>2. Benefícios das Application Actions:</strong></p><p>Em contraste com os Page Objects, as Application Actions permitem que os testes interajam diretamente com a lógica interna do aplicativo, em vez de depender dos elementos da página. Isso torna os testes mais rápidos, pois não há necessidade de pesquisar e manipular elementos da página. Além disso, as Application Actions podem ser reutilizadas em diferentes testes, o que melhora a modularidade e a manutenção dos testes automatizados.</p><p>As Application Actions também ajudam a manter os testes independentes e isolados, pois não há compartilhamento de estado entre eles. Cada teste pode executar suas próprias ações no aplicativo, sem se preocupar com o estado dos elementos da página.</p><p><strong>3. Exemplos de uso de Application Actions no Cypress:</strong></p><p>O Cypress é um framework de testes automatizados popular que suporta o uso de Application Actions. Vejamos alguns exemplos de como usar Application Actions no Cypress:</p><p><strong>Exemplo 1:</strong> Application Actions para fazer login</p><pre>javascript<br>function fazerLogin(usuario, senha) {<br> cy.visit(&#39;/login&#39;);<br> cy.get(&#39;#username&#39;).type(usuario);<br> cy.get(&#39;#password&#39;).type(senha);<br> cy.get(&#39;#login-button&#39;).click();<br>}<br>it(&#39;Deve fazer login com sucesso&#39;, () =&gt; {<br> fazerLogin(&#39;usuario&#39;, &#39;senha&#39;);<br> cy.get(&#39;#welcome-message&#39;).should(&#39;contain&#39;, &#39;Bem-vindo!&#39;);<br>});</pre><p>Neste exemplo, a função fazerLogin é uma ação do aplicativo que encapsula as etapas necessárias para fazer login. O teste automatizado chama essa ação e, em seguida, verifica se a mensagem de boas-vindas é exibida corretamente.</p><p><strong>Exemplo 2:</strong> Ação do aplicativo para adicionar um item ao carrinho de compras</p><pre>javascript<br>function adicionarItemAoCarrinho(item) {<br> cy.visit(&#39;/produtos&#39;);<br> cy.get(&#39;.item&#39;).contains(item).click();<br> cy.get(&#39;#adicionar-ao-carrinho&#39;).click();<br>}<br>it(&#39;Deve adicionar um item ao carrinho de compras&#39;, () =&gt; {<br> adicionarItemAoCarrinho(&#39;Camiseta&#39;);<br> cy.get(&#39;#carrinho&#39;).should(&#39;contain&#39;, &#39;Camiseta&#39;);<br>});</pre><p>Neste exemplo, a função <em>adicionarItemAoCarrinho</em> é uma ação do aplicativo que encapsula as etapas necessárias para adicionar um item ao carrinho de compras. O teste automatizado chama essa ação e, em seguida, verifica se o item foi adicionado corretamente ao carrinho.</p><p><strong>4. Conclusão:</strong></p><p>Embora os Page Object tenham sido amplamente adotados como uma prática recomendada para testes automatizados, eles têm problemas significativos de manutenção, introdução de estado adicional e lentidão nos testes. Em contraste, as Application Actions oferecem benefícios como maior velocidade, modularidade e independência dos testes. Ao adotar as Application Actions em vez dos Page Object, os desenvolvedores podem melhorar a produtividade e a eficiência dos testes automatizados.</p><p><strong>Dicionário:</strong></p><ul><li>Application Actions: Ações do Aplicativo</li><li>Page Objects: Objetos de Página</li><li>End-to-end tests: Testes de ponta a ponta</li><li>Encapsulate: Encapsular</li><li>Elements: Elementos</li><li>Fragile tests: Testes frágeis</li><li>Maintainable: Fácil de manter</li><li>Slow: Lento</li><li>Additional calls: Chamadas adicionais</li><li>Execution time: Tempo de execução</li><li>Productive: Produtivo</li><li>Focus on: Concentrar-se em</li><li>Cypress: Cypress</li></ul><p>Referências:</p><ul><li>Cypress Documentation: https://docs.cypress.io/</li><li>- “Page Objects vs. Actions in Cypress” by Gleb Bahmutov: https://www.cypress.io/blog/2019/01/03/stop-using-page-objects-and-start-using-app-actions/</li><li>- “Page Objects vs. Actions in Cypress” by Filip Hric: https://filiphric.com/page-objects-vs-actions-in-cypress</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1987fdd6857b" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[AIMA: como expandir a atuação de QA's através de indicadores]]></title>
            <link>https://medium.com/revista-tspi/aima-como-expandir-a-atua%C3%A7%C3%A3o-de-qas-atrav%C3%A9s-de-indicadores-1a8c60b87605?source=rss-4fdb4b1bb5c8------2</link>
            <guid isPermaLink="false">https://medium.com/p/1a8c60b87605</guid>
            <category><![CDATA[quality-software]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[qa-testing]]></category>
            <category><![CDATA[quality-assurance]]></category>
            <dc:creator><![CDATA[Jonas Davila]]></dc:creator>
            <pubDate>Wed, 01 Jul 2020 16:18:57 GMT</pubDate>
            <atom:updated>2020-07-01T16:18:57.134Z</atom:updated>
            <content:encoded><![CDATA[<p>Com mais empresas se utilizando de <a href="https://www.webpeak.com.br/blogs/o-que-e-kpi-como-onde-e-quando-usar-a-gente-te-explica">KPI’s (<em>Key Success Indicator</em>)</a> para mensurar sua taxa de qualidade em softwares, surgem novas oportunidades para pessoas analistas de qualidade.</p><p>As possibilidades são diversas: quando somos inseridos em times ou organizações com práticas pouco definidas ou onde o <a href="https://jonasdavila.com.br/index.php/2020/01/02/analista-de-qualidade-qual-sua-importancia-em-um-projeto/">papel da QA</a> ainda não é compreendido.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HR622O1WCsc6-z4vwdnhMw.jpeg" /></figure><h4>Sabemos que as atividades desenvolvidas pelas QA’s dependem do contexto, mas existe um método que você pode utilizar para visualizar pontos de melhoria de forma fácil, assim, agregando valor à empresa e ao seu time rapidamente.</h4><p>Quando aceitamos a oportunidade de atuar em uma equipe sem processos bem definidos de qualidade, <strong>precisamos estar prontos para responder as duas seguintes perguntas:</strong> &quot;Como você vai agregar valor ao time?&quot; e &quot;Quais são as atividades que vai desempenhar?&quot;</p><p>A resposta será sempre a mesma: <strong>entender o contexto e identificar pontos de melhoria. Desta forma, você pode trabalhar para ser estratégico em suas ações, </strong>pois qualquer afirmação não fundamentada em fatos e dados tem grandes possibilidades de não se concretizar, além de demonstrar que as decisões não foram tomadas em conjunto com o time.</p><h3>Vou te apresentar o método<strong> AIMA (</strong>Análise, Impacto, Metrificação e Apresentação<strong>):</strong></h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sqz9YSiTeG4xH3bqIBpO9g.png" /></figure><h4><strong>Análise</strong></h4><p>Neste primeiro momento, colete o máximo de informações possíveis e faça anotações. Ao observar intencionalmente, conseguimos identificar pontos de melhoria, que podem ser encontrados por meio de qualquer interação com a equipe, em reuniões ou cerimônias.</p><p>Além disso, uma forma que gera trocas virtuosas é por meio do <strong>pareamento.</strong> Esta prática vai acelerar o entendimento das tecnologias utilizadas no projeto e na empresa.</p><p>Essa etapa gera insumos para identificação dos pontos que podemos gerar valor com o menor esforço possível.</p><h4><strong>Impacto</strong></h4><p>Para impactar precisamos gerar uma atuação valorosa solucionando os problemas cotidianos mais evidentes e que requerem um retrabalho frequente.</p><p>Fortes pontos a serem melhorados serão sempre aqueles que exigem maior investimento de esforço e tempo, mas caso não sejam realizados podem ter impacto negativo para o produto ou negócio.</p><p><strong>Você pode guiar suas ações a partir dos seguintes pontos:</strong></p><ul><li>Crie relações de confiança com seu time;</li><li>Coloque a experiência da usuária final no centro das decisões;</li><li>Argumente a partir das <em>KPI&#39;s</em> escolhidas;</li><li>Sempre que necessário alinhe as expectativas com as <em>stakeholders</em> do projeto.</li></ul><p>A partir desta postura, você ganhará mais espaço para propor mudanças e novas soluções, contribuindo significativamente para a qualidade das entregas.</p><h4><strong>Metrificação</strong></h4><p>&quot;O que não é medido não pode ser melhorado&quot;. Então, quando pensamos em qualidade de software, mensurar impacto é importante para sabermos se estamos no caminho certo. Caso contrário, podemos mudar a estratégia para alinhar com os objetivos do negócio.</p><p>As métricas a serem mapeadas vão depender de quais metas foram elencadas para serem alcançadas, como por exemplo: taxa de cobertura de código, defeitos encontrados em produção, complexidade ciclomática.</p><p>Por meio de métricas podemos atestar a confiabilidade e consistência do trabalho desenvolvido, utilizando isso como insumo para tomar decisões estratégicas.</p><h4><strong>Apresentação</strong></h4><p>Este é um momento crucial em nosso ciclo, pois é por meio dele que demonstramos nossa taxa de sucesso utilizando os indicadores elencados no início do planejamento.</p><p>Neste ponto, devemos realizar a apresentação das metas trabalhadas durante o período estipulado, expondo o resultado dos impactos causados pelo plano de ação do time.</p><p>Além dos pontos trabalhados, devemos dar visibilidade de quais foram as lições aprendidas a partir dos resultados já obtidos e quais serão próximos passos a serem desenvolvidos no próximo ciclo.</p><h3>O método AIMA na prática</h3><h4>Contexto:</h4><p>Isabelle foi contratada por uma empresa do setor financeiro e recebeu a informação que se juntará a um time recém formado, responsável por realizar o desenvolvimento de uma nova funcionalidade para seu sistema principal. A funcionalidade deverá compensar o pagamento de boletos em até 1h.</p><h4>Passo 1: análise</h4><p>Após ser incorporada no time, Isabelle inicia suas observações, tomando nota de tudo que pode ser relevante. <strong>Ao interagir com o time, ela realiza questionamentos sobre a nova funcionalidade, de que modo funciona o fluxo de compensação atual, quais os motivos da mudança, qual é o prazo para implementação e como funciona a arquitetura do projeto.</strong></p><p>Entre as interações, ela recebe a informação que seu time foi incumbido de realizar um aumento da taxa de qualidade do projeto, tendo como primeiro objetivo ter uma cobertura de código de 30% .</p><p>Ao conversar com o time, Isabelle percebe que hoje não são realizados testes em nenhuma camada da aplicação, percebendo que existe um desalinhamento entre a KPI estabelecida pela gestão e postura do time em relação a mesma.</p><p>Isabelle descobre que no início do projeto, uma desenvolvedora chamada Fernanda chegou a iniciar a criação de testes unitários, mas que acabou por não dar continuidade por conta da demanda de entregas e falta de engajamento do restante do time.</p><h4>Passo 2: impacto</h4><p>Isabelle conversa com Fernanda e apresenta uma estratégia de testes embasada na KPI proposta, iniciando por um ponto de grande risco que é o módulo responsável por realizar a compensação do pagamento de boleto em até 1h, sendo que o prazo anterior era de até 3 dias.</p><p>Como apoio de Fernanda, Isabelle argumenta junto ao time a importância da realização dos testes e quais seriam os impactos do mesmo caso ocorresse uma falha na compensação dos pagamentos.</p><p>Assim, o time acorda em iniciar o desenvolvimento de testes unitários para o módulo responsável por compensar os pagamentos. Então, Isabelle e Fernanda ficam responsáveis por iniciar a atividade no próximo ciclo de desenvolvimento.</p><p>Logo ao iniciar a criação dos primeiros testes, Isabelle e Fernanda percebem que ao testar nos períodos do anos que anteriormente eram atribuídos ao inicio e fim do horário de verão, o sistema se comporta de maneira inesperada. Descobrindo, assim, que havia uma inconsistência no sistema, que ainda estava considerando horário de verão em sua lógica.</p><h4>Passo 3: metrificação</h4><p>Para poder medir qual o nível de cobertura de código atingido, Isabelle e Fernanda utilizam uma ferramenta de <em>code coverage</em> para gerar um report da porcentagem de linhas cobertas por teste.</p><p>Esta pratica além de expor o que não está coberto por testes, possibilita ao time tomar decisões estratégicas ao identificar quais pontos estão menos cobertos por testes e, em conjunto com uma estratégia de analise de riscos, detectar quais são as áreas do sistema que devem ser priorizadas ao criar testes.</p><h4>Passo 4: apresentação</h4><p>Após final do ciclo de desenvolvimento, Isabelle e Fernanda utilizam as informações coletadas para realizar uma apresentação aos stakeholders demonstrando a evolução em relação à meta estabelecida.</p><p>Demonstram que obtiveram um aumento da taxa de cobertura em 8% e que o próximo passo será implementar uma step de testes na rotina da pipeline do projeto.</p><p>Com a apresentação, mais membros da equipe tomaram conhecimento da importância de testes nos projeto e estimaram tempo de desenvolvimento, já incluindo os testes.</p><p><em>Podemos concluir que para alinhar o resultado dos processo de qualidade de software com as expectativas das stakeholders e KPI&#39;s propostos, é necessário demonstrar visibilidade sobre o processo a ser utilizado. Desta forma, conseguimos receber feedbacks para aprimorar as ações a cada novo ciclo que rodamos. Quando sabemos onde queremos chegar, alcançar o objetivo é só questão de tempo.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1a8c60b87605" width="1" height="1" alt=""><hr><p><a href="https://medium.com/revista-tspi/aima-como-expandir-a-atua%C3%A7%C3%A3o-de-qas-atrav%C3%A9s-de-indicadores-1a8c60b87605">AIMA: como expandir a atuação de QA&#39;s através de indicadores</a> was originally published in <a href="https://medium.com/revista-tspi">Revista eQAlizando (antiga Revista TSPI)</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>