Aula 4 · 15 min
Ferramenta não é para sempre: a página registra quando a função existe e remove quando sai de cena. Na spec de 16/10/2026 não há unregisterTool; quem remove é o signal de um AbortController. E quem chama pode cancelar uma execução no meio. Nesta aula você vê o ciclo inteiro e os eventos que o navegador dispara.
Começar a aula
Objetivo: registrar, listar, remover com AbortSignal e cancelar uma execução, sabendo quais eventos o navegador dispara em cada passo.
Clique em cada passo.
Medido em 19/10/2026: o Chromium 156 dispara os três eventos; o polyfill 6.0.3 só toolchange.
Trecho de kit/scripts/ciclo.mjs (roda dentro da página). Dois controllers: um para o registro, outro para a chamada.
const registro = new AbortController();
await mc.registerTool({
name: 'tarefa_lenta', description: 'Leva 2 segundos. Existe só para ensinar cancelamento.',
async execute(_, { signal }) {
return new Promise((ok, falha) => {
const t = setTimeout(() => ok({ terminou: true }), 2000);
signal.addEventListener('abort', () => { clearTimeout(t); falha(new DOMException('cancelada', 'AbortError')); });
});
}
}, { signal: registro.signal });
const t = (await mc.getTools()).find(x => x.name === 'tarefa_lenta');
const chamada = new AbortController();
setTimeout(() => chamada.abort(), 100);
try { await mc.executeTool(t, {}, { signal: chamada.signal }); }
catch (e) { /* AbortError */ }
registro.abort(); // remove a ferramenta: não existe unregisterToolcd ~/projetos/formacao-webmcp-site-v72/kit node scripts/ciclo.mjs nativo; echo "saída: $?" node scripts/ciclo.mjs polyfill; echo "saída: $?"
== Chromium 156.0.8078.4 (Playwright) · modo: nativo antes: 4 ferramentas registrou tarefa_lenta: 5 ferramentas nome repetido: recusado (InvalidStateError) execução cancelada pelo chamador: AbortError depois do abort(): 4 ferramentas eventos: toolchange toolactivated:tarefa_lenta toolcancel:tarefa_lenta toolchange saída: 0 == Chromium 156.0.8078.4 (Playwright) · modo: polyfill antes: 4 ferramentas registrou tarefa_lenta: 5 ferramentas nome repetido: recusado (InvalidStateError) execução cancelada pelo chamador: AbortError depois do abort(): 4 ferramentas eventos: toolchange toolchange saída: 0
Mesma sequência nos dois. A diferença está na linha "eventos": só o nativo dispara toolactivated e toolcancel.
Se o execute não ouve signal, o cancelamento rejeita a chamada, mas o trabalho continua: o setTimeout dispara, o fetch completa, a reserva acontece. Em ferramenta com efeito, confira signal.aborted antes de gravar.
Mesma regra em qualquer framework: registrar no início, abortar no fim.
Registre depois de a regra estar pronta e aborte no pagehide.
É o que iniciarWebMCP faz no kit.
addEventListener('pagehide', () => pagina.abort(), { once: true })
Ferramenta de uma tela só existe enquanto a tela está montada.
Trocou de rota: abort() e registre as da tela nova.
Em React, registre no efeito e aborte no cleanup; o modo estrito monta duas vezes e o nome repetido daria InvalidStateError.
O padrão vale para outros frameworks; a aula 7 mostra o modelo.
Se a terceira de quatro falha, as duas primeiras ficam penduradas.
O registrar() do kit usa um controller por lote e aborta tudo na falha.
Ensaio nos dois modos com API. Cada exercício termina num pronto quando.
Rode o bloco do ciclo e leia linha a linha.
Pronto quando: node scripts/ciclo.mjs nativo → nome repetido: recusado (InvalidStateError), execução cancelada pelo chamador: AbortError, depois do abort(): 4 ferramentas e eventos: toolchange toolactivated:tarefa_lenta toolcancel:tarefa_lenta toolchange.
Rode o mesmo no polyfill e anote no seu status-webmcp.md (aula 1) o que o polyfill não faz.
Pronto quando: node scripts/ciclo.mjs polyfill → eventos: toolchange toolchange e saída: 0; a linha está no seu arquivo.
Rode os testes de regra do kit: um deles simula a 2ª ferramenta falhando no registro.
Pronto quando: node --test 2>&1 | grep -E "^ℹ (pass|fail)" → ℹ pass 4 e ℹ fail 0.
A explicação aparece depois da resposta.
Pergunta 1 de 4
Como se remove uma ferramenta na spec de 16/10/2026?
Pergunta 2 de 4
Quem chama aborta a execução. O que acontece com o execute?
Pergunta 3 de 4
Seu teste espera toolactivated e roda só no polyfill 6.0.3. O que acontece?
Pergunta 4 de 4
Num componente React, onde vai o abort()?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.