From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/pt-br/web/api/abortsignal/aborted/index.html | 62 +++++++++++++ files/pt-br/web/api/abortsignal/index.html | 101 +++++++++++++++++++++ 2 files changed, 163 insertions(+) create mode 100644 files/pt-br/web/api/abortsignal/aborted/index.html create mode 100644 files/pt-br/web/api/abortsignal/index.html (limited to 'files/pt-br/web/api/abortsignal') diff --git a/files/pt-br/web/api/abortsignal/aborted/index.html b/files/pt-br/web/api/abortsignal/aborted/index.html new file mode 100644 index 0000000000..6158b810e9 --- /dev/null +++ b/files/pt-br/web/api/abortsignal/aborted/index.html @@ -0,0 +1,62 @@ +--- +title: AbortSignal.aborted +slug: Web/API/AbortSignal/aborted +tags: + - API + - AbortSignal + - Propriedade + - aborted +translation_of: Web/API/AbortSignal/aborted +--- +
{{APIRef("DOM")}}{{SeeCompatTable}}
+ +

A propriedade aborted é apenas para leitura e fornece um valor {{domxref("Boolean")}} indicando se as solicitações ao objeto sinal de comunicação DOM forão abortadas (true) ou não (false).

+ +

Sintaxe

+ +
var isAborted = abortSignal.aborted;
+ +

Valor

+ +

Um valor {{domxref("Boolean")}}

+ +

Exemplos

+ +

No fragmento abaixo, criamos um novo objeto AbortController e recebemos dele um sinal {{domxref("AbortSignal")}} (disponível na propriedade signal). Depois checamos se o sinal foi ou não abortado usando a propriedade aborted, e então enviamos um log apropriado para o console.

+ +
var controller = new AbortController();
+var signal = controller.signal;
+
+// ...
+
+signal.aborted ? console.log('Pedido foi abortado') : console.log('Pedido nao foi abortado');
+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoEstadoComentário
{{SpecName('DOM WHATWG', '#dom-abortsignal-onabort', 'onabort')}}{{Spec2('DOM WHATWG')}}Definição Inicial
+ +

Compatibilidade de Navegadores

+ + + +

{{Compat("api.AbortSignal.aborted")}}

+ +

Veja Também

+ + diff --git a/files/pt-br/web/api/abortsignal/index.html b/files/pt-br/web/api/abortsignal/index.html new file mode 100644 index 0000000000..1bfd9766c7 --- /dev/null +++ b/files/pt-br/web/api/abortsignal/index.html @@ -0,0 +1,101 @@ +--- +title: AbortSignal +slug: Web/API/AbortSignal +tags: + - API + - AbortSignal + - DOM + - Experimental + - Interface + - Referencia +translation_of: Web/API/AbortSignal +--- +
{{APIRef("DOM")}}{{SeeCompatTable}}
+ +

A interface AbortSignal  representa o sinal de um objeto que permite a você se comunicar com uma Requisição de DOM (como Fetch) e aborta-la se necessário via um objeto {{domxref("AbortController")}}

+ +

Propriedades

+ +

A interface AbortSignal também herda propriedades de sua interface pai, {{domxref("EventTarget")}}.

+ +
+
{{domxref("AbortSignal.aborted")}} {{readonlyInline}}
+
Um {{domxref("Boolean")}} que indica quando a(s) Request(s) com a qual o sinal está se comunicando está/estão abortadas(true) ou não(false).
+
+ +

Handlers de Eventos

+ +
+
{{domxref("AbortSignal.onabort")}}
+
Invocado quando um {{event("abort_(dom_abort_api)", "abort")}} evento dispara, ex: quando as requests do DOM que o sinal estão se comunicando são/estão abortadas.
+
+ +

Métodos

+ +

A interface AbortSignal também herda métodos de sua interface pai, {{domxref("EventTarget")}}.

+ +

Exemplos

+ +

No exemplo de código a seguir, nós vamos focar em fazer download de um vídeo usando a Fetch API.

+ +

Nós primeiro criaremos um controller usando o construtor do {{domxref("AbortController.AbortController","AbortController()")}}, e então pegar a referência de seu objeto {{domxref("AbortSignal")}} associado usando a propriedade {{domxref("AbortController.signal")}}.

+ +

Quando a requisição Fetch é iniciada, nós passamos o AbortSignal  como uma opção dentro do objeto de opções da request (veja {signal}, abaixo). Isso associa o sinal e o controller com a requisição fetch e nos permite aborta-la chamando {{domxref("AbortController.abort()")}}, como visto abaixo no segundo event listener.

+ +
var controller = new AbortController();
+var signal = controller.signal;
+
+var downloadBtn = document.querySelector('.download');
+var abortBtn = document.querySelector('.abort');
+
+downloadBtn.addEventListener('click', fetchVideo);
+
+abortBtn.addEventListener('click', function() {
+  controller.abort();
+  console.log('Download aborted');
+});
+
+function fetchVideo() {
+  ...
+  fetch(url, {signal}).then(function(response) {
+    ...
+  }).catch(function(e) {
+    reports.textContent = 'Download error: ' + e.message;
+  })
+}
+ +
+

Nota: Quando abort() é chamado, a promessa do fetch() é rejeitada com um AbortError.

+
+ +

Você pode encontrar um exemplo completo no GitHub — veja abort-api (see it running live also).

+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('DOM WHATWG', '#interface-AbortSignal', 'AbortSignal')}}{{Spec2('DOM WHATWG')}}Initial definition
+ +

Compatibilidade de Browser

+ + + +

{{Compat("api.AbortSignal")}}

+ +

Veja Também

+ + -- cgit v1.2.3-54-g00ecf