Skip to content

Commit

Permalink
pt-br: Convert noteblocks to GFM Alerts (part 6) (#22770)
Browse files Browse the repository at this point in the history
* pt-br: Convert noteblocks to GFM Alerts (part 6)

This PR converts the noteblocks for the Portugese Brazilian locale to GFM Alerts syntax, using a [conversion script](https://github.com/queengooborg/mdn-toolkit/blob/main/upgrade-noteblock.js). This is part 6. Note: manual adjustments have also been made to correct some issues, including capitalization, syntax, duplicated keywords and more.

* Update files/pt-br/web/javascript/reference/statements/label/index.md

Co-authored-by: Josiel Rocha <[email protected]>

* Fixes

---------

Co-authored-by: Josiel Rocha <[email protected]>
  • Loading branch information
queengooborg and josielrocha authored Aug 8, 2024
1 parent 8d8fef2 commit 4644abd
Show file tree
Hide file tree
Showing 31 changed files with 155 additions and 77 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,8 @@ if (x === undefined) {
}
```

> **Nota:** Observação: O operador de igualdade estrita (`===`) tem que ser utilizado aqui uma vez que `x == undefined` também checa se `x` é nulo, enquanto o operador não o faz. `null` não é equivalente à `undefined`. Veja {{jsxref("Operators/Comparison_Operators", "operadores de comparação")}} (em inglês) para maiores detalhes.
> [!NOTE]
> O operador de igualdade estrita (`===`) tem que ser utilizado aqui uma vez que `x == undefined` também checa se `x` é nulo, enquanto o operador não o faz. `null` não é equivalente à `undefined`. Veja {{jsxref("Operators/Comparison_Operators", "operadores de comparação")}} (em inglês) para maiores detalhes.
### `Operador Typeof` e `undefined`

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,8 @@ slug: Web/JavaScript/Reference/Global_Objects/unescape

{{jsSidebar("Objects")}}{{Deprecated_header}}A função **unescape()** obsolta computa uma nova string na qual as sequencias hexadecimal são esquecidas com o caractere que representa. As sequências de escape podem ser introduzidas como funções {{jsxref("escape")}}. Porque a função 'unescape' está obsoleta, ao invez disso, use {{jsxref("decodeURI")}} ou {{jsxref("decodeURIComponent")}}.

> **Nota:** Não use `unescape` para decodificar URIs, use `decodeURI` ao invez disso.
> [!NOTE]
> Não use `unescape` para decodificar URIs, use `decodeURI` ao invez disso.
## Syntax

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,8 @@ Um objeto é um iterador quando implementa um método **`next()`** com a semânt
</tbody>
</table>

> **Nota:** Não é possível saber de forma reflexiva se um determinado objeto implementa o protocolo do iterador, no entanto, é fácil criar um objeto que satisfaça tanto o iterador quanto os protocolos iteráveis (como mostrado no exemplo abaixo). Fazer isso permite que um iterador seja consumido pelas várias sintaxes que iteráveis esperam. Assim, raramente é desejável implementar o protocolo do iterador sem também implementar iteráveis.
> [!NOTE]
> Não é possível saber de forma reflexiva se um determinado objeto implementa o protocolo do iterador, no entanto, é fácil criar um objeto que satisfaça tanto o iterador quanto os protocolos iteráveis (como mostrado no exemplo abaixo). Fazer isso permite que um iterador seja consumido pelas várias sintaxes que iteráveis esperam. Assim, raramente é desejável implementar o protocolo do iterador sem também implementar iteráveis.
>
> ```js
> var myIterator = {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,8 @@ var a, b;
({ a, b } = { a: 1, b: 2 });
```

> **Nota:** Os parênteses `( ... )` ao redor da declaração de atribuição é uma sintaxe necessária quando se utiliza a atribuição via desestruturação de objeto literal sem uma declaração.
> [!NOTE]
> Os parênteses `( ... )` ao redor da declaração de atribuição é uma sintaxe necessária quando se utiliza a atribuição via desestruturação de objeto literal sem uma declaração.
>
> `{a, b} = {a:1, b:2}` não é uma sintaxe stand-alone válida, pois `{a, b}` no lado esquerdo é considarada um bloco, não um objeto literal.
>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,8 @@ Usar encadeamento opcional com chamadas de função faz com que a expressão aut
let result = someInterface.customMethod?.();
```
> **Nota:** Se existe uma propriedade com tal nome e que não é uma função, usando `?.` ainda lançará a exceção {{JSxRef("TypeError")}} (`x.y is not a function`).
> [!NOTE]
> Se existe uma propriedade com tal nome e que não é uma função, usando `?.` ainda lançará a exceção {{JSxRef("TypeError")}} (`x.y is not a function`).

#### Lidando com callbacks opcionais ou manipuladores de eventos

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,8 @@ x - y

### Subtração com strings

> **Warning:** Note que o JavaScript sempre tentará converter uma String em numero número
> [!WARNING]
> Note que o JavaScript sempre tentará converter uma String em numero número
```js
"foo" - 3; // NaN
Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/javascript/reference/operators/this/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,8 @@ f2() === undefined; // true

Portanto, em modo estrito, se `this` não for definido durante o contexto da execução, ele permanecerá indefinido (`undefined`).

> **Nota:** No segundo exemplo, `this` deveria ser [`undefined`](/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/undefined), porque `f2` foi chamada diretamente e não como um método ou popriedade de um objeto (ou seja, `window.f2()`). Esta característica não foi implementada em alguns navegadores quando começaram a dar suporte ao [strict mode](/pt-BR/docs/Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode) (modo estrito). Como resultado, eles incorretamente retornavam o objeto `window`.
> [!NOTE]
> No segundo exemplo, `this` deveria ser [`undefined`](/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/undefined), porque `f2` foi chamada diretamente e não como um método ou popriedade de um objeto (ou seja, `window.f2()`). Esta característica não foi implementada em alguns navegadores quando começaram a dar suporte ao [strict mode](/pt-BR/docs/Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode) (modo estrito). Como resultado, eles incorretamente retornavam o objeto `window`.
### Funções Arrow (seta)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ Um **escape de classe de caracteres unicode** é um tipo de [escape de classe de

- : Nome ou valor de uma propriedade Unicode solitária, seguindo a mesma sintaxe como `valor`. Ela especifica o valor para a propriedade `General_Category` (Categoria Geral), ou um [nome binário de propriedade (en-US)](https://tc39.es/ecma262/multipage/text-processing.html#table-binary-unicode-properties). No modo [`v`](/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/RegExp/unicodeSets), também pode ser uma [propriedade Unicode binária de textos (en-US)](https://tc39.es/ecma262/multipage/text-processing.html#table-binary-unicode-properties-of-strings).

> **Nota:** A sintaxe [ICU (en-US)](https://unicode-org.github.io/icu/userguide/strings/unicodeset.html#property-values) permite omitir o nome da propriedade `Script` também, mas o JavaScript não suporta isso, porque na maioria dos casos a propriedade `Script_Extensions` é mais útil que a `Script`.
> [!NOTE]
> A sintaxe [ICU (en-US)](https://unicode-org.github.io/icu/userguide/strings/unicodeset.html#property-values) permite omitir o nome da propriedade `Script` também, mas o JavaScript não suporta isso, porque na maioria dos casos a propriedade `Script_Extensions` é mais útil que a `Script`.
- `propriedade`
- : O nome de uma propriedade Unicode. Deve ser composto de letras {{Glossary("ASCII")}} (`A–Z`, `a–z`) e underscores (`_`), e deve ser um dos [nome de propriedades não binárias (en-US)](https://tc39.es/ecma262/multipage/text-processing.html#table-nonbinary-unicode-properties).
Expand All @@ -42,7 +43,8 @@ Para compor múltiplas propriedades, use a sintaxe de [intersecção de conjunto

No modo `v`, `\p` pode corresponder a uma sequências de pontos de código, definida no Unicode como "propriedades de textos". Isto é mais útil para emojis, que são frequentemente compostos por múltiplos pontos de código. Contudo, `\P` pode apenas complementar as propriedades do caracter.

> **Nota:** Existem planos de portar a funcionalidade de propriedades de texto para o modo `u` também.
> [!NOTE]
> Existem planos de portar a funcionalidade de propriedades de texto para o modo `u` também.
## Exemplos

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,8 @@ Quando uma função assíncrona é chamada, ela retorna uma {{jsxref("Promise")}

Uma função assíncrona pode conter uma expressão {{jsxref("Operators/await", "await")}}, que pausa a execução da função assíncrona e espera pela resolução da `Promise` passada, e depois retoma a execução da função assíncrona e retorna o valor resolvido.

> **Nota:** A proposta das funções `async/await` é de simplificar o uso de forma síncrona das `Promises` e executar alguns procedimentos em um grupo de `Promises`. Assim como `Promises` são similares a `callbacks` estruturados, funções `async/await` são similares à junção de `generators` com `Promises`.
> [!NOTE]
> A proposta das funções `async/await` é de simplificar o uso de forma síncrona das `Promises` e executar alguns procedimentos em um grupo de `Promises`. Assim como `Promises` são similares a `callbacks` estruturados, funções `async/await` são similares à junção de `generators` com `Promises`.
## Exemplos

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,8 @@ export { function1, function2 };

Mas onde `function1` e `function2` não ficam disponíveis dentro do módulo atual.

> **Nota:** Os exemplos a seguir são sintaticamente inválidos apesar de sua equivalência com o import:
> [!NOTE]
> Os exemplos a seguir são sintaticamente inválidos apesar de sua equivalência com o import:
```js
import DefaultExport from "bar.js"; // Válido
Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/javascript/reference/statements/for/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,8 @@ showOffsetPos("content");
// top: 153px;"
```

> **Nota:** Nesse caso, quando você não usa a seção de declaração, **o** **ponto-e-vírgula é colocada imediatamente após a declaração do ciclo**.
> [!NOTE]
> Nesse caso, quando você não usa a seção de declaração, **o** **ponto-e-vírgula é colocada imediatamente após a declaração do ciclo**.
## Especificações

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,9 @@ label :
- `declaração`
- : Uma declaração qualquer. _break_ pode ser utilizado com qualquer declaração entiquetada (com _label_) , assim como o _continue_ também pode.

> **Aviso:** ### Evite usar labelsLabels não são comunmente utilizados em JavaScript já que estes fazem com que programas fiquei mais difíceis de ler e entender. Sempre que possível evite utilizar labels e, dependendo dos casos, prefira [chamar funções](/pt-BR/docs/JavaScript/Reference/Statements/function) ou [lançar um erro](/pt-BR/docs/JavaScript/Reference/Statements/throw).
### Evite usar labels

Labels não são comunmente utilizados em JavaScript já que estes fazem com que programas fiquei mais difíceis de ler e entender. Sempre que possível evite utilizar labels e, dependendo dos casos, prefira [chamar funções](/pt-BR/docs/JavaScript/Reference/Statements/function) ou [lançar um erro](/pt-BR/docs/JavaScript/Reference/Statements/throw)

## Exemplos

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,8 @@ a + b;

O console irá alertar "unreachable code after return statement" (código inacessível após a declaração return).

> **Nota:** A partir do Gecko 40, um alerta é mostrado no console se um código inacessível é encontrado após uma declaração `return`.
> [!NOTE]
> A partir do Gecko 40, um alerta é mostrado no console se um código inacessível é encontrado após uma declaração `return`.
## Exemplos

Expand Down
6 changes: 4 additions & 2 deletions files/pt-br/web/javascript/reference/statements/with/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,8 @@ title: with
slug: Web/JavaScript/Reference/Statements/with
---

> **Aviso:** O uso da declaração `with` não é recomendado, isso porque ele pode ser a fonte de bugs confusos e problemas de compatibilidade. Veja o parágrafo "Contra de ambiguidade" na seção "Descrição" para mais detalhes.
> [!WARNING]
> O uso da declaração `with` não é recomendado, isso porque ele pode ser a fonte de bugs confusos e problemas de compatibilidade. Veja o parágrafo "Contra de ambiguidade" na seção "Descrição" para mais detalhes.
{{jsSidebar("Statements")}}

Expand All @@ -25,7 +26,8 @@ with (expressão)

JavaScript procura por um nome não qualificado procurando uma cadeia de escopo associada à execução do contexto do script ou função contendo um nome não qualificado. A declaração 'with' adiciona o dado objeto à frenet dessa cadeia de escopo durante a validação desse corpo de declarações. Se um nome não qualificado usado no corpo for igual ao de uma propriedade na cadeia de escopo, então o nome ficará ligado à propriedade e ao objeto contendo a propriedade. Senão, um {{jsxref("ReferenceError")}} será invocado.

> **Nota:** Usar `with` não é recomendado, e está probido no [strict mode](/pt-BR/docs/Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode) do ECMAScript 5. A alternativa recomendada é atribuir o objeto cujas propriedades você quer acessar a uma variável temporária.
> [!NOTE]
> Usar `with` não é recomendado, e está probido no [strict mode](/pt-BR/docs/Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode) do ECMAScript 5. A alternativa recomendada é atribuir o objeto cujas propriedades você quer acessar a uma variável temporária.
### Pros & contras de perfomance

Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/javascript/reference/strict_mode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,8 @@ delete Object.prototype; // lança TypeError

Quarto, strict mode anterior ao Gecko 34 requer que todas as propriedades nomeadas em um objeto literal sejam únicas. Código normal pode duplicar nomes de propriedades, sendo que a última ocorrência determina o valor da propriedade. Mas como apenas o último faz algo, a duplicação é meramente um vetor de bugs, se o código for modificado para mudar o valor da propriedade por outro meio que não modificando a última instância. Nomes de propriedades duplicados são erro de sintaxe em strict mode:

> **Nota:** Não é mais o caso no ECMAScript 6 ([Erro do Firefox 1041128](https://bugzil.la/1041128)).
> [!NOTE]
> Não é mais o caso no ECMAScript 6 ([Erro do Firefox 1041128](https://bugzil.la/1041128)).
```js
"use strict";
Expand Down
18 changes: 12 additions & 6 deletions files/pt-br/web/manifest/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,11 @@ Manifesto de aplicativos web são implementados em suas páginas HTML usando uma
<link rel="manifest" href="/manifest.webmanifest" />
```

> **Nota:** A extensão `.webmanifest` está especificada na sessão de [Media type registration](https://w3c.github.io/manifest/#media-type-registration) da especificação, mas no geral os navegadores suportam manifestos em outras extensões apropriadas como `.json`
> [!NOTE]
> A extensão `.webmanifest` está especificada na sessão de [Media type registration](https://w3c.github.io/manifest/#media-type-registration) da especificação, mas no geral os navegadores suportam manifestos em outras extensões apropriadas como `.json`
> **Nota:** Se o manifesto precisa de credenciais para ser buscado, você [deve](https://github.com/w3c/manifest/issues/186#issuecomment-43939505) adicionar o atributo [`crossorigin`](/pt-BR/docs/Web/HTML/CORS_settings_attributes) mesmo que o arquivo de manifesto esteja na mesma origem da página atual.
> [!NOTE]
> Se o manifesto precisa de credenciais para ser buscado, você [deve](https://github.com/w3c/manifest/issues/186#issuecomment-43939505) adicionar o atributo [`crossorigin`](/pt-BR/docs/Web/HTML/CORS_settings_attributes) mesmo que o arquivo de manifesto esteja na mesma origem da página atual.
## Exemplo de manifesto

Expand Down Expand Up @@ -87,7 +89,8 @@ Define a "cor de fundo" esperada para o website. Este valor repete o que já é
"background_color": "red"
```

> **Nota:** O membro `background_color` tem o único intuito de melhorar a experiência de usuário enquanto o site apontado está carregando, e não deve ser usado pelo agente de usuário como o {{cssxref("background-color", "background color")}} quando a folha de estilo do aplicativo web progressivo (PWA) estiver disponível.
> [!NOTE]
> O membro `background_color` tem o único intuito de melhorar a experiência de usuário enquanto o site apontado está carregando, e não deve ser usado pelo agente de usuário como o {{cssxref("background-color", "background color")}} quando a folha de estilo do aplicativo web progressivo (PWA) estiver disponível.
### description

Expand All @@ -113,7 +116,8 @@ Pode ter um dos valores a seguir:
- `rtl` (right-to-left)
- `auto` (hints to the browser to use the Unicode bidirectional algorithm to make a best guess about the text's direction.)

> **Nota:** When the value is omitted, it defaults to `auto`.
> [!NOTE]
> When the value is omitted, it defaults to `auto`.
### display

Expand Down Expand Up @@ -191,7 +195,8 @@ Valid values are:
</tbody>
</table>

> **Nota:** You can selectively apply CSS to your app based on the display mode, using the [display-mode](/docs/Web/CSS/@media/display-mode) media feature. This can be used to provide a consistent user experience between launching a site from an URL and launching it from a desktop icon.
> [!NOTE]
> You can selectively apply CSS to your app based on the display mode, using the [display-mode](/docs/Web/CSS/@media/display-mode) media feature. This can be used to provide a consistent user experience between launching a site from an URL and launching it from a desktop icon.
### icons

Expand Down Expand Up @@ -270,7 +275,8 @@ Specifies a boolean value that hints for the user agent to indicate to the user
"prefer_related_applications": false
```

> **Nota:** If omitted, the value defaults to `false`.
> [!NOTE]
> If omitted, the value defaults to `false`.
### related_applications

Expand Down
6 changes: 4 additions & 2 deletions files/pt-br/web/media/formats/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,8 @@ O contêiner Ogg pode também conter um áudio codificado usando o [codec FLAC](

O formato MP4 com o codec de vídeo H.264 e codec de áudio AAC tem suporte nativo para Internet Explorer, Safari e Chrome no desktop e dispositivos móveis, o Opera não possui suporte para este formato. IE e Chrome também possuem suporte para codec de áudio MP3 no container MP4, mas o Safari não tem suporte para isso. Firefox/Firefox para hardware do dispositivo pode manipular o perfil utilizado para codificar o MP4.

> **Nota:** Codificação MP4 com um perfil elevado não será executado em um hardware inferior, como o Firefox OS.
> [!NOTE]
> Codificação MP4 com um perfil elevado não será executado em um hardware inferior, como o Firefox OS.
O formato de mídia MPEG é coberto por patentes, do qual não é livremente licenciado. Todas as licenças necessárias podem ser compradas da MPEG LA. Desde H.264 o formato não é livre de direitos autorais, é impróprio para a internet aberta, de acordo com a Mozilla \[[1](http://shaver.off.net/diary/2010/01/23/html5-video-and-codecs/), [2](http://robert.ocallahan.org/2010/01/video-freedom-and-mozilla_23.html)], Google \[[1](http://blog.chromium.org/2011/01/html-video-codec-support-in-chrome.html), [2](http://blog.chromium.org/2011/01/more-about-chrome-html-video-codec.html)] e Opera. Contudo, desde que os formatos de direitos livres não são suportados pelo Internet Explorer e Safari, a [Mozilla decidiu dar suporte para o formato](https://hacks.mozilla.org/2012/03/video-mobile-and-the-open-web/), e a Google nunca cumpriu sua promessa de remover o suporte para o Chrome.

Expand All @@ -92,7 +93,8 @@ Gecko reconhece os seguintes tipos MIME em arquivos de áudio WAVE:

Por exemplo, [você pode implementar MPEG-DASH usando JavaScript durante carregamento da decodificação para MSE](http://msopentech.com/blog/2014/01/03/streaming_video_player/).

> **Nota:** Time Shifting é o processo de consumo de uma transmissão ao vivo, algum tempo após ter acontecido.
> [!NOTE]
> Time Shifting é o processo de consumo de uma transmissão ao vivo, algum tempo após ter acontecido.
## Veja também

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@ original_slug: Web/Security/Securing_your_site

Há várias coisas que você pode fazer para ajudar na segurança do seu site. Esse artigo oferece uma série de sugestões, bem como links para outros artigos fornecendo informações mais úteis.

> **Nota:** Esse artigo é um trabalho em progresso e não está nem completo nem as sugestões a seguir irão garantir que seu site será completamente seguro.
> [!NOTE]
> Esse artigo é um trabalho em progresso e não está nem completo nem as sugestões a seguir irão garantir que seu site será completamente seguro.
## Segurança da informação do usuário

Expand Down
Loading

0 comments on commit 4644abd

Please sign in to comment.