Como o próprio nome da interface diz, uma promessa não pode ser quebrada. Desse modo, por si só, Promise
s não são passíveis de cancelamento no JavaScript.
No entanto, o Axios oferece um mecanismo de cancelamento de requisições.
Basicamente, você precisa criar um token de cancelamento e passa ao construtor da requisição. Algo assim:
const CancelToken = axios.CancelToken;
// Criamos a origem do token de cancelamento:
const cancelTokenSource = CancelToken.source();
axios.get('/path/of/request', {
// Passamos o token de cancelamento para o construtor da requisição:
cancelToken: cancelTokenSource.token
});
// Note que a chamada acima retorna uma promessa.
Note que cancelTokenSource
(retornado pela aplicação de CancelToken.source
) possui uma propriedade token
(que é o token de cancelamento), mas também possui um método cancel
, que deve ser usado para cancelar a requisição. Você pode utilizá-lo passando um motivo para o cancelamento:
cancelTokenSource.cancel('Não é mais de meu interesse enviar esta requisição.');
Uma vez que o cancel
seja invocado, a Promise
que o construtor da requisição retorna será rejeitada. Você poderá, então, utilizar o catch
para tratar essa rejeição:
axios.get('/path/of/request', {
// Passamos o token de cancelamento para o construtor da requisição:
cancelToken: cancelTokenSource.token
}).catch(function (thrown) {
// Utilizamos o método `isCancel` para saber se o erro da rejeição veio de um cancelamento:
if (axios.isCancel(thrown)) {
console.log('Request canceled', thrown.message);
} else {
// Trate o erro.
}
});
Como a rejeição é notificada através da rejeição da promessa, não há problemas em tratá-la com async
/await
:
async function doRequest() {
try {
const response = axios.get('/path/of/request', {
// Passamos o token de cancelamento para o construtor da requisição:
cancelToken: cancelTokenSource.token
});
// Faça algo com `response`.
} catch (thrown) {
if (axios.isCancel(thrown)) {
console.log('Request canceled', thrown.message);
} else {
// Trate o erro.
}
}
}
Como cancelTokenSource
está "fora da requisição", você pode cancelar a operação de qualquer lugar. Só tome cuidado para não utilizar um mesmo token para mais de uma requisição, caso contrário esse mesmo token poderá cancelar todas as requisições em que foi utilizado ao mesmo tempo.
Se a requisição for cancelada, como já vimos acima, a promessa que o construtor da requisição (como axios.get
ou axios.post
) retornar é, por garantia, rejeitada. Isso significa que, uma vez que você cancele uma requisição do Axios, a promessa jamais será resolvida.
Não há menção explícita disto documentação do Axios, mas uma vez que a requisição é cancelada (utilizando cancelTokenSource.cancel()
), ela é, de fato, abortada. Esse comportamento é comprovado pelo próprio código-fonte da biblioteca. Veja a implementação do abortamento no adaptador xhr
(API dos browsers) e no adaptador http
(módulo nativo do Node.js).
É um mecanismo bem similar ao AbortController
, que permite o cancelamento de requisições com a API nativa fetch
.
promisse
ainda não foi executada? ou foi?