Skip to content

Translate 'Dev tools' page #24

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 7, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 30 additions & 30 deletions 1-js/01-getting-started/4-devtools/article.md
Original file line number Diff line number Diff line change
@@ -1,64 +1,64 @@
# Developer console
# Konsola deweloperska

Code is prone to errors. You will quite likely make errors... Oh, what am I talking about? You are *absolutely* going to make errors, at least if you're a human, not a [robot](https://en.wikipedia.org/wiki/Bender_(Futurama)).
Kod jest podatny na błędy i ty prawdopodobnie będziesz je popełniać. Co ja mówię... Z *całą pewnością* będziesz popełniać błędy. Jesteś przecież człowiekiem, a nie [robotem](https://en.wikipedia.org/wiki/Bender_(Futurama).

But in the browser, users don't see errors by default. So, if something goes wrong in the script, we won't see what's broken and can't fix it.
Jednak w przeglądarce użytkownicy domyślnie nie widzą błędów. Jeśli coś pójdzie nie tak, nie dowiesz się, co się popsuło i tym samym nie będziesz w stanie tego naprawić.

To see errors and get a lot of other useful information about scripts, "developer tools" have been embedded in browsers.
Do przeglądarek internetowych dołączane są tzw. "narzędzia deweloperskie", w których możesz zobaczyć błędy skryptów i wiele innych przydatnych informacji.

Most developers lean towards Chrome or Firefox for development because those browsers have the best developer tools. Other browsers also provide developer tools, sometimes with special features, but are usually playing "catch-up" to Chrome or Firefox. So most developers have a "favorite" browser and switch to others if a problem is browser-specific.
Większość programistów skłania się ku przeglądarkom Chrome i Firefox, ponieważ mają najbardziej zaawansowane narzędzia. Inne przeglądarki również je mają, czasem ze specjalnymi funkcjami, ale zazwyczaj jedynie próbują nadrobić zaległości w stosunku do Chrome'a lub Firefoksa. Programiści zwykle jednak mają swoją "ulubioną" przeglądarkę i przełączają się na inną dopiero, gdy muszą naprawić błąd specyficzny dla tej przeglądarki.

Developer tools are potent; they have many features. To start, we'll learn how to open them, look at errors, and run JavaScript commands.
Narzędzia deweloperskie są bardzo rozbudowane i mają wiele funkcjonalności. Zaczniemy od ich otwarcia, zajrzenia do błędów i uruchomienia pierwszych komend javascriptowych.

## Google Chrome

Open the page [bug.html](bug.html).
Otwórz stronę [bug.html](bug.html).

There's an error in the JavaScript code on it. It's hidden from a regular visitor's eyes, so let's open developer tools to see it.
W kod JavaScript tej strony wkradł się błąd. Błąd skryptu jest niewidoczny dla zwykłego odwiedzającego. Otwórzmy zatem narzędzia programistyczne, aby móc go zobaczyć.

Press `key:F12` or, if you're on Mac, then `key:Cmd+Opt+J`.
Naciśnij `key:F12`, chyba że korzystasz z Maca - wtedy naciśnij `key:Cmd+Opt+I`.

The developer tools will open on the Console tab by default.
Narzędzia deweloperskie uruchomią się domyślnie z aktywną zakładką "Konsola".

It looks somewhat like this:
Powinno to wyglądać jak na zdjęciu poniżej:

![chrome](chrome.png)

The exact look of developer tools depends on your version of Chrome. It changes from time to time but should be similar.
Dokładny widok narzędzi deweloperskich zależy od wersji Chrome'a. Narzędzia zmieniają się od czasu do czasu, ale ogólnie rzecz biorąc powinny być podobne.

- Here we can see the red-colored error message. In this case, the script contains an unknown "lalala" command.
- On the right, there is a clickable link to the source `bug.html:12` with the line number where the error has occurred.
- Widzimy treść błędu zapisaną kolorem czerwonym. W tym przypadku skrypt zawiera nieznaną komendę "lalala".
- Po prawej stronie jest klikalny link do źródła `bug.html:12`, z numerem linii kodu, w której błąd wystąpił.

Below the error message, there is a blue `>` symbol. It marks a "command line" where we can type JavaScript commands. Press `key:Enter` to run them (`key:Shift+Enter` to input multi-line commands).
Poniżej treści błędu znajduje się niebieski symbol `>`. Oznacza linię, w której możemy pisać kod JavaScript. Naciśnij `key:Enter`, aby ten kod uruchomić (`key:Shift+Enter` dodaje nowy wiersz).

Now we can see errors, and that's enough for a start. We'll come back to developer tools later and cover debugging more in-depth in the chapter <info:debugging-chrome>.
Widzisz już komunikaty błędów i na początek powinno to wystarczyć. W rozdziale pt. "<info:debugging-chrome>" wrócimy do narzędzi deweloperskich, by poznać więcej tajników debuggowania.


## Firefox, Edge, and others
## Firefox, Edge i inne

Most other browsers use `key:F12` to open developer tools.
W przypadku większości przeglądarek klawisz `key:F12` otwiera narzędzia deweloperskie.

The look & feel of them is quite similar. Once you know how to use one of these tools (you can start with Chrome), you can easily switch to another.
Z wyglądu i zachowania są do siebie dość podobne. Jeśli wiesz, w jaki sposób obsługiwać narzędzia deweloperskie w jednej z przeglądarek (możesz zacząć od Chrome), z łatwością odnajdziesz się w innych.

## Safari

Safari (Mac browser, not supported by Windows/Linux) is a little bit special here. We need to enable the "Develop menu" first.
Safari (przeglądarka na Macach, nie wspierana w systemach Windows/Linux) jest nieco specyficzna. Aby zacząć korzystać z narzędzi deweloperskich, musimy najpierw włączyć "Programowanie".

Open Preferences and go to the "Advanced" pane. There's a checkbox at the bottom:
Otwórz Preferencje i przejdź do zakładki "Zaawansowane". Zaznacz na samym dole pole "Pokazuj menu Programowanie na pasku menu", jak na obrazku poniżej:

![safari](safari.png)

Now `key:Cmd+Opt+C` can toggle the console. Also, note that the new top menu item named "Develop" has appeared. It has many commands and options.
Teraz, gdy naciśniesz `key:Cmd+Opt+C`, otworzysz konsolę. Warto dodać, że w górnym pasku menu pojawiła się nowa pozycja o nazwie "Programowanie". Ma w sobie wiele funkcji i opcji konfiguracyjnych.

```smart header="Multi-line input"
Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
## Wpisywanie w wielu wierszach

To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
```
Zazwyczaj gdy wprowadzamy kod JavaScript w konsoli i naciśniemy klawisz `key:Enter`, wykona się on od razu.

## Summary
Aby wstawić kod, który ma kilka linii, wystarczy wcisnąć na końcu linii klawisz `key:Shift+Enter`, aby przejść do następnej.

- Developer tools allow us to see errors, run commands, examine variables, and much more.
- They can be opened with `key:F12` for most browsers on Windows. Chrome for Mac needs `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (need to enable first).
## Podsumowanie

Now we have the environment ready. In the next section, we'll get down to JavaScript.
- Narzędzia deweloperskie pozwalają podejrzeć błędy, uruchomić komendy javascriptowe, sprawdzać zmienne i wiele, wiele innych.
- W większości przeglądarek dla systemu Windows można je włączyć za pomocą klawisza `key:F12`. Chrome dla Maca wymaga naciśnięcia `key:Cmd+Opt+I`, natomiast Safari: `key:Cmd+Opt+C` (pamiętaj, by w Safari najpierw włączyć "Programowanie").

Mamy już gotowe środowisko. W następnym rozdziale przejdziemy wreszcie do pisania kodu JavaScript.
2 changes: 1 addition & 1 deletion 1-js/01-getting-started/4-devtools/bug.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

<body>

There is an error in the script on this page.
Na tej stronie do skryptu wkradł się błąd.
<script>
lalala
</script>
Expand Down