From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../pt-br/web/api/closeevent/closeevent/index.html | 71 ++++++ files/pt-br/web/api/closeevent/index.html | 239 +++++++++++++++++++++ 2 files changed, 310 insertions(+) create mode 100644 files/pt-br/web/api/closeevent/closeevent/index.html create mode 100644 files/pt-br/web/api/closeevent/index.html (limited to 'files/pt-br/web/api/closeevent') diff --git a/files/pt-br/web/api/closeevent/closeevent/index.html b/files/pt-br/web/api/closeevent/closeevent/index.html new file mode 100644 index 0000000000..d5b7f088c0 --- /dev/null +++ b/files/pt-br/web/api/closeevent/closeevent/index.html @@ -0,0 +1,71 @@ +--- +title: CloseEvent() +slug: Web/API/CloseEvent/CloseEvent +tags: + - API + - CloseEvent + - Construtor + - Referencia +translation_of: Web/API/CloseEvent/CloseEvent +--- +
{{APIRef("Websockets API")}}
+ +

O construtor CloseEvent()cria uma nova instância {{domxref("CloseEvent")}}.

+ +

Sintaxe

+ +
var event = new CloseEvent(typeArg, closeEventInit);
+ +

Valores

+ +
+
typeArg
+
É uma {{domxref("DOMString")}} que representa o nome do evento.
+
closeEventInit {{optional_inline}}
+
+ +
+
É uma coleção CloseEventInit, que possui os seguintes campos: + +
    +
  • "wasClean", opcional e inicialmente de valor false, do tipo long, indica se uma conexão foi encerrada de forma limpa ou não.
  • +
  • "code", opcional e inicialmente de valor 0, do tipo unsigned short, este é o código de encerramento da conexão enviado pelo servidor.
  • +
  • "reason", opcional e inicialmente de valor '', do tipo {{domxref("DOMString")}}, esta é uma razão humanamente compreensível do porque o servidor encerrou a conexão.
  • +
+ +
+

A coleção CloseEventInit também aceita campos vindos da coleção {{domxref("Event.Event", "EventInit")}}.

+
+
+
+ +

Especificações

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG','comms.html#closeevent','CloseEvent()')}}{{Spec2('HTML WHATWG')}}Definição inicial
+ +

Compatibilidade de navegadores

+ + + +

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

+ +

Veja também

+ + diff --git a/files/pt-br/web/api/closeevent/index.html b/files/pt-br/web/api/closeevent/index.html new file mode 100644 index 0000000000..94f718e8b2 --- /dev/null +++ b/files/pt-br/web/api/closeevent/index.html @@ -0,0 +1,239 @@ +--- +title: CloseEvent +slug: Web/API/CloseEvent +translation_of: Web/API/CloseEvent +--- +

{{APIRef("Websockets API")}}

+ +

Um CloseEvent é enviado aos clientes que usam {{Glossary("WebSockets")}} quando a conexão está fechada (closed). Ele é enviado ao ouvinte(listener) pelo atributo onclose do objeto WebSocket.

+ +

Construtor

+ +
+
{{domxref("CloseEvent.CloseEvent", "CloseEvent()")}}
+
Cria um CloseEvent novo.
+
+ +

Propriedades

+ +

Esta interface também herda as propriedades de seu objeto pai, {{domxref("Event")}}.

+ +
+
{{domxref("CloseEvent.code")}} {{readOnlyInline}}
+
Retorna um valor unsigned short contendo o código de encerramento enviado pelo servidor. Os seguintes valores são status de códigos permitidos. As definições seguintes são originadas da página da IANA [Ref]. Observe que os códigos 1xxx são exclusivamente Websockets internos e não para os mesmos propósitos dos dados enviados (como quando o protocolo da camada de aplicação é invalido). Os únicos códigos que permitem especificação no Firefox são o 1000 e do 3000 ao 4999 [Source, Bug]. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Código de StatusNomeDescrição
0999Reservado e não utilizado.
1000CLOSE_NORMALEncerramento normal. A conexão foi completada com sucesso sempre que o propósito para o qual ela foi criada tenha sido atingida.
1001CLOSE_GOING_AWAYO "endpoint" desapareceu, por causa de uma falha no servidor ou por que o navegador navegou para fora da página que abriu a conexão.
1002CLOSE_PROTOCOL_ERRORO "endpoint" finalizou a conexão devido a um erro de protocolo.
1003CLOSE_UNSUPPORTEDA conexão está sendo finalizada por causa de o dado do "endpoint" recebido ser de um tipo que não pode ser aceito (por exemplo, um "text-only endpoint" recebido como dado binário).
1004Reservado. Um significado pode ser definido futuramente.
1005CLOSE_NO_STATUSReservado.  Indica que um código "no status" foi fornecido mesmo que qualquer outro código seja esperado.
1006CLOSE_ABNORMALReservado. Usado para indicar que uma conexão foi fechada anormalmente (isto é, sem o "close frame" ter sido enviado) quando um "status code" é esperado.
1007Unsupported DataO "endpoint" está finalizando a conexão por causa da mensagem ter sido recebida com dados inconsistentes (por exemplo, dados que não estejam no padrão UTF-8, dentro de uma mensagem de texto).
1008Policy ViolationO "endpoint" está finalizando a conexão por causa dele ter recebido uma mensagem que viola sua política. Este é um código de status genérico, usado quando o código 1003 e o código 1009 não sejam adequados.
1009CLOSE_TOO_LARGEO "endpoint" está finalizando a conexão por causa de que o "data frame" recebido é muito grande.
1010Missing ExtensionO cliente está fechando a conexão por causa de que navegador espera o servidor negociar uma ou mais extensões esperadas, o servidor não responde corretamente.
1011Internal ErrorO servidor está finalizando uma conexão por causa de que ele encontrou uma condição inesperada que o impediu de cumprir a solicitação.
1012Service Restart +

O servidor está finalizando uma conexão por que ele está em processo de "restar". [Ref]

+
1013Try Again Later +

O servidor está finalizando a conexão devido a uma condição temporária, por exemplo, ele estar sobrecarregado e estar rejeitando alguns dos seus clientes. [Ref]

+
1014Reservado para o futuro uso de um padrão WebSocket.
1015TLS Handshake +

Reservado. Indica que a conexão foi fechada devido a uma falha para executar um " TLS handshake" (por exemplo, o certificado do servidor não pode ser verificado).

+
10161999Reservado para o futuro uso de um padrão WebSocket.
20002999Reservado para uso de "WebSocket extensions".
30003999 +

Disponível para uso de bibliotecas e frameworks. Não pode ser usado para aplicações. Disponível para registro em "IANA via first-come, first-serve".

+
40004999Disponível para uso em aplicações.
+
+
{{domxref("CloseEvent.reason")}} {{readOnlyInline}}
+
Retorna um {{domxref("DOMString")}} indicando a razão do porquê o servidor fechou uma conexão. Isto é especifico para um servidor e sub-protocolo particular.
+
{{domxref("CloseEvent.wasClean")}} {{readOnlyInline}}
+
Retorna um {{jsxref("Boolean")}} indicando se a conexão está ou não está claramente fechada.
+
+ +

Métodos

+ +

Esta interface também herda as propriedades de seu objeto pai, {{domxref("Event")}}.

+ +
+
{{domxref("CloseEvent.initCloseEvent()")}} {{Non-standard_inline}} {{Obsolete_inline}}
+
Inicializa o valor de um CloseEvent criado. Se o evento já tenha sido enviado, este método não realiza nada.  Não use este método mais, use o construtor {{domxref("CloseEvent.CloseEvent", "CloseEvent()")}} em vez disso.
+
+ +

Compatibilidade nos navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatUnknown}}{{CompatGeckoDesktop("8.0")}}[1]
+ {{CompatGeckoDesktop("12.0")}}[2]
10{{CompatUnknown}}{{CompatUnknown}}
initCloseEvent() {{Non-standard_inline}}{{CompatNo}}{{CompatGeckoDesktop("8.0")}}
+ {{CompatNo}} 41.0
{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatGeckoMobile("8.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
initCloseEvent() {{Non-standard_inline}}{{CompatNo}}{{CompatGeckoMobile("8.0")}}
+ {{CompatNo}} 41.0
{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +

[1] Anterior ao Gecko 8.0 {{geckoRelease("8.0")}}, o Gecko envia o evento WebSocket {{event("close")}}  ao ouvinte como um evento simples. O suporte para o CloseEvent foi implementado no Gecko 8.0.

+ +

[2] Anterior ao Gecko 12.0 {{geckoRelease("12.0")}}, o Gecko reportava o código de encerramento CLOSE_NORMAL quando o canal se fechava devido a um erro inesperado, ou se a condição de erro não era coberta pela especificação. Agora CLOSE_GOING_AWAY é reportado em seu lugar.

+ +

Veja também

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