E-mail em desenvolvimento

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: um formulário de contato que manda e-mail para o suporte — e que você consegue desenvolver e testar sem um servidor de e-mail.

Com host: log, o q:mail grava cada mensagem no log em vez de enviá-la. A configuração lê o host do ambiente, então em produção basta definir SMTP_HOST:

# Recipe: mail in development. `host: log` writes each message to the log
# instead of sending it; set SMTP_HOST in production and the same page sends.
paths:
  components: ./components

mail:
  host: ${SMTP_HOST:-log}
  from: support@example.com

<q:component name="Contact">
  <q:action name="send" method="POST">
    <q:param name="email" type="email" required="true" />
    <q:param name="message" required="true" minlength="5" />
    <q:mail to="support@example.com" reply_to="{email}" subject="Contact from {email}" type="text">{message}</q:mail>
    <q:redirect url="/" flash="Thanks! We will answer {email}." />
  </q:action>

  <h1>Contact us</h1>
  <q:if condition="flash"><p class="flash">{flash}</p></q:if>
  <form method="POST" action="/?action=send">
    <input name="email" type="email" />
    <textarea name="message"></textarea>
    <button>Send</button>
  </form>
</q:component>

Os testes enviam o formulário e conferem o que o visitante ouve, e que um endereço ruim é recusado no seu campo antes de qualquer envio:

<q:test name="a message is sent and the visitor is told" page="/">
  <test:submit action="send" email="ana@example.com" message="Where is my order?" />
  <test:expect redirect="/" flash="Thanks! We will answer ana@example.com." />
</q:test>

<q:test name="an address that is not an e-mail is refused on its field" page="/">
  <test:submit action="send" email="not-an-email" message="Where is my order?" />
  <test:expect error="email" />
</q:test>

tests/contact.test.q
  PASS  a message is sent and the visitor is told
  PASS  an address that is not an e-mail is refused on its field
2 passed, 0 failed

E esta é a mensagem que o primeiro teste "enviou" — o que o host: log gravou:

q:mail (host: log, not sent)
From: support@example.com
To: support@example.com
Subject: Contact from ana@example.com

Where is my order?

Sem uma seção mail:, o q:mail é um erro que diz isso — ele nunca finge enviar. Mais em Files & Mail (em inglês).

Testado: esta página importa os arquivos de examples/cookbook/files-and-mail/mail-in-development/, e os resultados acima saíram de rodá-los.