Testar o que uma ação recusa

Tradução automática

Esta página foi traduzida automaticamente do inglês e ainda não foi revisada por um falante nativo; correções são bem-vindas no GitHub. Se algo não bater, vale o original em inglês. O código e os resultados são os mesmos do original, importados dos arquivos testados.

Tarefa: provar que um formulário recusa o que deve — um campo que quebra a sua regra, um valor que o negócio não permite — e que nada é gravado quando isso acontece.

Um cadastro com dois tipos de recusa: as regras dos q:param (verificadas antes de a ação rodar) e uma regra de negócio na própria ação (o endereço já é de um membro):

yaml

# Recipe: testing what an action refuses — field rules and a business rule.
paths:
  components: ./components
  migrations: ./migrations

datasources:
  db:
    driver: sqlite
    database: ./data/signup.db

sql

CREATE TABLE members (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT NOT NULL UNIQUE
);
INSERT INTO members (name, email) VALUES ('Ana', 'ana@example.com');

xml

<q:component name="Signup">
  <q:action name="join" method="POST">
    <q:param name="name" required="true" minlength="2" />
    <q:param name="email" type="email" required="true" />

    <q:query name="taken" datasource="db">
      SELECT id FROM members WHERE email = :email
      <q:param name="email" value="{email}" type="string" />
    </q:query>
    <q:if condition="taken_result.recordCount > 0">
      <q:redirect url="/" flash="{email} is already a member." flashType="error" />
    </q:if>

    <q:query name="added" datasource="db">
      INSERT INTO members (name, email) VALUES (:name, :email)
      <q:param name="name" value="{name}" type="string" />
      <q:param name="email" value="{email}" type="string" />
    </q:query>
    <q:redirect url="/" flash="Welcome, {name}!" />
  </q:action>

  <h1>Join</h1>
  <q:if condition="flash"><p class="flash-{flashType}">{flash}</p></q:if>
  <form method="POST" action="/?action=join">
    <input name="name" />
    <input name="email" type="email" />
    <button>Join</button>
  </form>
</q:component>

error="name" verifica o campo em que o envio foi recusado, e message= o texto mostrado ao lado dele. Uma recusa que a própria ação decide é um redirecionamento com mensagem flash, verificado com flash=. table= com count= prova que nada foi gravado:

xml

<q:test name="a short name is refused on its field, with the rule's message" page="/">
  <test:submit action="join" name="A" email="bia@example.com" />
  <test:expect error="name" message="Must be at least 2 characters" />
  <test:expect table="members" count="0" where="email = 'bia@example.com'" />
</q:test>

<q:test name="an address that is not an e-mail is refused on its field" page="/">
  <test:submit action="join" name="Bia" email="bia-at-example" />
  <test:expect error="email" />
  <test:expect table="members" count="1" />
</q:test>

<q:test name="an address that is already a member is refused with a flash" page="/">
  <test:submit action="join" name="Ana Again" email="ana@example.com" />
  <test:expect redirect="/" flash="ana@example.com is already a member." />
  <test:expect table="members" count="1" />
</q:test>

<q:test name="a new member is welcomed" page="/">
  <test:submit action="join" name="Bia" email="bia@example.com" />
  <test:expect redirect="/" flash="Welcome, Bia!" />
  <test:expect table="members" count="1" where="email = 'bia@example.com'" />
</q:test>

text

tests/signup.test.q
  PASS  a short name is refused on its field, with the rule's message
  PASS  an address that is not an e-mail is refused on its field
  PASS  an address that is already a member is refused with a flash
  PASS  a new member is welcomed
4 passed, 0 failed

As regras que um q:param aceita (required, minlength, type="email", enum…) estão em Actions & Forms (em inglês).

Testado: esta página importa os arquivos de examples/cookbook/testing/action-errors/, e o resultado acima é o relatório de rodá-los.

Testar o que uma ação recusa ​

Testar o que uma ação recusa