Skip to content

Commit e97d7e0

Browse files
authored
Merge branch 'master' into fix/started-intro
2 parents 983dc03 + cbdd312 commit e97d7e0

File tree

553 files changed

+9927
-32437
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

553 files changed

+9927
-32437
lines changed

.gitattributes

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
11
* text=auto eol=lf
2+
*.svg binary

.github/FUNDING.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
github: iliakan

.gitignore

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,4 +21,6 @@ sftp-config.json
2121
Thumbs.db
2222

2323

24-
/svgs
24+
/svgs
25+
# VSCode workspace
26+
.vscode/

1-js/01-getting-started/1-intro/article.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -67,13 +67,15 @@ Exemplos de tais restrições incluem:
6767

6868
Os navegadores modernos permitem que ele trabalhe com arquivos, mas o acesso é limitado e fornecido apenas se o usuário executar determinadas ações, como "dropping" de um arquivo em uma janela do navegador ou selecioná-lo por meio de uma entrada de formulário.
6969

70-
Existem maneiras de interagir com a câmera/microfone e outros dispositivos, mas eles exigem permissão explícita do usuário. Assim, uma página com o JavaScript ativo não pode às encondidas habilitar uma câmera web, observar os arredores e enviar as informações para a [Agência de Segurança Nacional (NSA)](https://pt.wikipedia.org/wiki/Ag%C3%AAncia_de_Seguran%C3%A7a_Nacional).
71-
- Diferentes abas/janelas geralmente não se conhecem mutuamente. Mas às vezes sim, por exemplo, quando uma janela usa JavaScript para abrir outra. Mas, mesmo neste caso, o JavaScript numa página pode não acessar a outra se elas vierem de sites diferentes (de um domínio, protocolo ou porta diferentes).
70+
Existem maneiras de interagir com a câmera / microfone e outros dispositivos, mas eles exigem permissão explícita do usuário. Assim, uma página habilitada para JavaScript pode não habilmente habilitar uma câmera web, observar os arredores e enviar as informações para a [NSA](https://pt.wikipedia.org/wiki/Ag%C3%AAncia_de_Seguran%C3%A7a_Nacional).
71+
72+
- Diferentes abas/janelas geralmente não se conhecem mutuamente. Às vezes sim, por exemplo, quando uma janela usa JavaScript para abrir a outra. Mas mesmo neste caso, JavaScript de uma página pode não acessar a outra se eles vierem de sites diferentes (de um domínio, protocolo ou porta diferente).
7273

7374
Isto é chamado de "Política de mesma origem". Para contornar isso, *ambas as páginas* devem concordar em trocar dados e conter código JavaScript específico para o fazer.
7475

7576
Essa limitação é, novamente, para a segurança do usuário. Uma página de `http://umsitequalquer.com.br` que um usuário abriu não deve poder alcançar uma outra aba do navegador com a URL `http://gmail.com` e roubar a informação de lá.
76-
- O JavaScript pode se comunicar facilmente pela rede com o servidor de onde a página atual veio. Mas a sua capacidade de receber dados de outros sites/domínios é limitada. Embora possível, requer acordo explícito (expresso em cabeçalhos HTTP) do lado remoto. Mais uma vez, esta é uma limitação de segurança.
77+
78+
- O JavaScript pode se comunicar facilmente pela rede com o servidor de onde a página atual veio. Mas sua capacidade de receber dados de outros sites / domínios é prejudicada. Embora possível, requer acordo explícito (expresso em cabeçalhos HTTP) do lado remoto. Mais uma vez, isso é uma limitação de segurança.
7779

7880
![](limitations.svg)
7981

@@ -88,11 +90,12 @@ Há pelo menos *três* grandes aspectos do JavaScript:
8890
+ Coisas simples são feitas de forma simples.
8991
+ Suporte em todos os principais navegadores, e ativado por padrão.
9092
```
91-
O JavaScript é a única tecnologia de navegador que combina estas três qualidades.
93+
94+
JavaScript é a única tecnologia de navegador que combina estas três qualidades.
9295

9396
Isso é o que torna o JavaScript único. É por isso que é a ferramenta mais difundida para criar interfaces de navegador.
9497

95-
Dito isto, o JavaScript pode ser usado para criar servidores, aplicativos móveies, etc.
98+
Dito isso, o JavaScript pode ser usado para criar servidores, aplicativos móveis, etc.
9699

97100
## Linguagens "sobre" JavaScript
98101

1-js/01-getting-started/2-manuals-specifications/article.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
21
# Manuais e especificações
32

43
Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender gradualmente a linguagem. Mas uma vez familiarizado com o básico, irá precisar de outros recursos.
@@ -17,11 +16,11 @@ E mais, se você está desenvolvendo para browsers, há outras especificações
1716

1817
## Manuais
1918

20-
- **MDN (Mozilla) JavaScript Reference** é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções da linguagem, métodos , etc.
19+
- **MDN (Mozilla) JavaScript Reference** é um manual com exemplos e outras informações. É ótimo para um entendimento sobre funções da linguagem, métodos , etc.
2120

22-
Pode ser encontrado em <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
21+
Pode ser encontrado em <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
2322

24-
Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]" na busca, por exemplo: <https://google.com/search?q=MDN+parseInt> para procurar pela função `parseInt`.
23+
Porém, às vezes é melhor fazer uma busca na internet. Apenas use "MDN [termo]" na busca, por exemplo: <https://google.com/search?q=MDN+parseInt> para procurar pela função `parseInt`.
2524

2625
## Tabelas de compatibilidade
2726

1-js/01-getting-started/3-code-editors/article.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,6 @@ Na prática, os editores leves podem ter muitos plug-ins, incluindo analisadores
3131

3232
As seguintes opções merecem sua atenção:
3333

34-
- [Atom](https://atom.io/) (plataforma cruzada, livre).
3534
- [Sublime Text](http://www.sublimetext.com) (plataforma cruzada, shareware).
3635
- [Notepad++](https://notepad-plus-plus.org/) (Windows, livre).
3736
- [Vim](http://www.vim.org/) e [Emacs](https://www.gnu.org/software/emacs/) também são legais se você sabe como usá-los.
@@ -43,3 +42,9 @@ Os editores nas listas acima são aqueles que eu ou os meus amigos que eu consid
4342
Há outros grandes editores no nosso grande mundo. Por favor, escolha o que você mais gosta.
4443

4544
A escolha de um editor, como qualquer outra ferramenta, é individual e depende de seus projetos, hábitos e preferências pessoais.
45+
46+
Opinião pessoal do autor:
47+
48+
- Eu usaria o [Visual Studio Code](https://code.visualstudio.com/) se desenvolvesse principalmente para o frontend.
49+
50+
- Caso contrário, se o desenvolvimento for principalmente em outra linguagem/plataforma e parcialmente em frontend, considere outros editores, como o Xcode (Mac), o Visual Studio (Windows) ou a família JetBrains (WebStorm, PHPStorm, RubyMine etc., dependendo da linguagem).

1-js/01-getting-started/4-devtools/article.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Console do desenvolvedor
22

3-
O código é propenso a erros. Você provavelmente cometerá erros ... Oh, do que estou falando? Você está *inevitavelmente* cometendo erros, pelo menos se você for um humano, não um [robô] (https://pt.wikipedia.org/wiki/Bender_Bending_Rodr%C3%ADguez).
3+
O código é propenso a erros. Você provavelmente cometerá erros ... Oh, do que estou falando? Você está *inevitavelmente* cometendo erros, pelo menos se você for um humano, não um [robô](https://pt.wikipedia.org/wiki/Bender_Bending_Rodr%C3%ADguez).
44

5-
Mas no navegador, os usuários não vêem os erros por padrão. Assim, se algo correr mal no script, não veremos de onde está partindo e não poderemos corrigir.
5+
Mas no navegador, os usuários não veem os erros por padrão. Assim, se algo correr mal no script, não veremos de onde está partindo e não poderemos corrigir.
66

77
Para que possamos visualizar erros e obter muitas outras informações úteis sobre scripts, as "ferramentas de desenvolvedor" foram incorporadas aos navegadores.
88

@@ -22,7 +22,7 @@ As ferramentas de desenvolvedor serão abertas na aba Console por padrão.
2222

2323
É parecido com isto:
2424

25-
![chrome](chrome.png)
25+
![chrome](chrome.webp)
2626

2727
O aspecto exato das ferramentas de desenvolvimento depende da sua versão do Chrome. Ele muda de vez em quando, mas deve ser semelhante.
2828

@@ -33,10 +33,9 @@ Abaixo da mensagem de erro, há um símbolo azul `>`. Ele marca uma "linha de co
3333

3434
Agora podemos ver erros, e isso é suficiente para começar. Voltaremos mais tarde às ferramentas de desenvolvedor e abordaremos a depuração mais profundamente no capítulo <info:debugging-chrome>.
3535

36-
```smart header="Multi-line input"
37-
Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
38-
39-
To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
36+
```smart header="Múltiplas linhas de comando"
37+
Normalmente, quando colocamos uma linha de código no console e pressionamos `key:Enter`, o código sera executado.
38+
Para inserir várias linhas, pressione `key:Shift+Enter`. Dessa forma, será possível inserir longos fragmentos de código JavaScript.
4039
```
4140

4241
## Firefox, Edge, e outros
-41.1 KB
Binary file not shown.
22.2 KB
Loading
48.3 KB
Loading

0 commit comments

Comments
 (0)