Skip to content

Commit

Permalink
translation(Glossary): glossary/source_map (#3749)
Browse files Browse the repository at this point in the history
* translation(glossary): glossary/source_map

* chore: мініфікованим
  • Loading branch information
undead404 authored Dec 27, 2024
1 parent ad9cdc6 commit 5d17610
Show file tree
Hide file tree
Showing 4 changed files with 72 additions and 1 deletion.
70 changes: 70 additions & 0 deletions files/uk/glossary/source_map/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
title: Карта коду
slug: Glossary/Source_map
page-type: glossary-definition
---

{{GlossarySidebar}}

**Карта коду** – це формат файлу {{Glossary("JSON")}}, що містить відображення між мініфікованим або перетвореним кодом, отриманим браузером, і його вихідною незміненою формою, що дає змогу відновити вихідний код та використовувати його під час зневадження.

Код, що виконується браузером, нерідко певним чином перетворений відносно вихідного коду, створеного розробником. Це може бути зроблено з кількох причин:

- Аби зробити доставлення коду з сервера більш ефективним шляхом об'єднання та мініфікації вихідних файлів.
- Аби підтримувати старші браузери, перетворюючи сучасні можливості на їхні старі еквіваленти.
- Аби користуватися мовами, які браузери не підтримують, такими як {{Glossary("TypeScript")}} або [Sass](https://sass-lang.com/).

У таких ситуаціях зневадження вихідного коду набагато простіше, ніж зневадження коду в перетвореному стані, який браузер звантажив.
Браузери виявляють карту коду за допомогою заголовка HTTP {{HTTPHeader("SourceMap")}} для ресурсу або анотації `sourceMappingURL` у згенерованому коді.

## Приклад

Для прикладу, розгляньмо такий синтаксис SCSS мови Sass:

```scss
ul {
list-style: none;
li {
display: inline;
}
}
```

Під час процесу збирання SCSS перетворюється на CSS.
Генерується і підключається з CSS у коментарі в кінці файл карти коду `index.css.map`:

```css
ul {
list-style: none;
}
ul li {
display: inline;
}

/*# sourceMappingURL=index.css.map */
```

Цей файл карти містить не лише відображення між вихідним SCSS і згенерованим CSS, але й вихідний код SCSS у закодованому вигляді. Він ігнорується розбирачем CSS браузера, але використовується Інструментами розробника в браузері:

```json
{
"version": 3,
"sourceRoot": "",
"sources": ["index.scss"],
"names": [],
"mappings": "AAAA;EACC;;AACA;EACC",
"file": "index.css"
}
```

Ця карта коду дає Інструментам розробника в браузері змогу посилатися на конкретні рядки в оригінальному файлі SCSS та показувати вихідний код:

![Інструменти розробника Firefox спрямовані на елемент li в інспекторі DOM. Панель стилів показує перетворений CSS, без вкладеності, та посилається на третій рядок у файлі index.scss.](inspector.png)

![Інструменти розробника Firefox з файлом index.scss, відкритим у редакторі стилів. Редактор спрямований на третій рядок у вихідному коді в форматі SCSS, зі вкладеністю.](style-editor.png)

## Дивіться також

- [Специфікація формату карти коду](https://tc39.es/ecma426/2024/)
- Заголовок відповіді HTTP {{HTTPHeader("SourceMap")}}
- [Інструменти розробника Firefox – використання карт коду](https://firefox-source-docs.mozilla.org/devtools-user/debugger/how_to/use_a_source_map/index.html)
Binary file added files/uk/glossary/source_map/inspector.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added files/uk/glossary/source_map/style-editor.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion uk_spelling_additions.txt
Original file line number Diff line number Diff line change
Expand Up @@ -232,17 +232,18 @@
міжцаринних
мікроможливість
мініфікації
мініфікованим
множиноподібний
множиноподібним
множиноподібними
множиноподібні
множиноподібності
мовозалежним
мовозалежними
надспецифічних
наведеності
надкреслення
надкреслень
надспецифічних
Найден
налаштовність
налаштовності
Expand Down

0 comments on commit 5d17610

Please sign in to comment.