Skip to content

Commit

Permalink
[ru] replace old noteblock syntax with GFM syntax in 'mozilla' folder
Browse files Browse the repository at this point in the history
  • Loading branch information
leon-win committed Jul 29, 2024
1 parent b75339a commit dc6c529
Show file tree
Hide file tree
Showing 19 changed files with 79 additions and 68 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,8 @@ gettingAll.then(logCookies);

{{WebExtExamples}}

> **Примечание:** Это API основано на API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies#type-Cookie). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
> [!NOTE]
> Этот API основан на Chromium API [`chrome.cookies`](https://developer.chrome.com/extensions/cookies#type-Cookie). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
3 changes: 2 additions & 1 deletion files/ru/mozilla/add-ons/webextensions/api/cookies/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,8 @@ In order to use this API, an add-on must specify the "cookies" [API permission](

{{WebExtExamples("h2")}}

> **Примечание:** Это API основано на API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
> [!NOTE]
> Этот API основан на Chromium API [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Эта документация основана на [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) из кода Chromium.
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/downloads

{{WebExtExamples("h2")}}

> **Примечание:** Это API основано на API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads).
> [!NOTE]
> Этот API основан на Chromium API [`chrome.downloads`](https://developer.chrome.com/extensions/downloads).
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,8 @@ console.log(manifest.name);

{{WebExtExamples}}

> **Примечание:** Это API основано на API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime). Эта документация основана на [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) из кода Chromium.
> [!NOTE]
> Этот API основан на Chromium API [`chrome.runtime`](https://developer.chrome.com/extensions/runtime). Эта документация основана на [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) из кода Chromium.
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
3 changes: 2 additions & 1 deletion files/ru/mozilla/add-ons/webextensions/api/tabs/get/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,8 @@ browser.tabs.get(

{{WebExtExamples}}

> **Примечание:** Этот API основан на Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-get) API. Это документация получена из [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) в коде Chromium.
> [!NOTE]
> Этот API основан на Chromium API [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-get) API. Это документация получена из [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) в коде Chromium.
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/webRequest

{{WebExtExamples("h2")}}

> **Примечание:** Это API основано на API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Эта документация основана на [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) из кода Chromium.
> [!NOTE]
> Этот API основан на Chromium API [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Эта документация основана на [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) из кода Chromium.
<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/windows/CreateType

{{WebExtExamples}}

> **Примечание:** Это API основано на API Chromium [`chrome.windows`](https://developer.chrome.com/extensions/windows#type-CreateType). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
> [!NOTE]
> Этот API основан на Chromium API [`chrome.windows`](https://developer.chrome.com/extensions/windows#type-CreateType). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
>
> Информация о совместимости Microsoft Edge предоставлена корпорацией Microsoft и включена здесь под лицензией Creative Commons Attribution 3.0 United States License.
Expand Down
3 changes: 2 additions & 1 deletion files/ru/mozilla/add-ons/webextensions/api/windows/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,8 @@ slug: Mozilla/Add-ons/WebExtensions/API/windows

{{WebExtExamples("h2")}}

> **Примечание:** Это API основано на API Chromium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
> [!NOTE]
> Этот API основан на Chromium API [`chrome.windows`](https://developer.chrome.com/extensions/windows). Эта документация основана на [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) из кода Chromium.
>
> Информация о совместимости Microsoft Edge предоставлена корпорацией Microsoft и включена здесь под лицензией Creative Commons Attribution 3.0 United States License.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,10 @@ slug: Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities

Веб расширения разработаны с поддержкой совместимости с расширениями Chrome и Оперы на сколько это возможно. Расширения, написанные для этих браузеров, должны работать в Firefox с минимальными изменениями.

Всё же, Firefox на данный момент имеет поддержку только для ограниченного набора функций и API, поддержуемых в Chrome и Опере. Мы работаем над добавлением большей поддержки, но много функций пока ещё не поддерживаются и некоторые из них никогда не будут поддерживаться.
Всё же, Firefox на данный момент имеет поддержку только для ограниченного набора функций и API, поддерживаемых в Chrome. Мы работаем над добавлением большей поддержки, но много функций пока ещё не поддерживаются и некоторые из них никогда не будут поддерживаться.

Эта статья перечисляет все функции и API, которые полностью поддерживаются в Firefox Developer Edition (на данный момент Firefox 47). Там где функция поддерживается частично, мы указали на проблемные места.

> **Примечание:** You should assume that features and APIs not listed here at all are not yet supported.
## manifest.json функция

### Полностью поддерживаемые ключи
Expand Down
54 changes: 27 additions & 27 deletions files/ru/mozilla/add-ons/webextensions/content_scripts/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,29 +13,25 @@ slug: Mozilla/Add-ons/WebExtensions/Content_scripts

Встраиваемые скрипты имеют доступ только к [небольшому подмножеству методов WebExtension API](/ru/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#%D0%92%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5_%D1%81_%D1%84%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%BC%D0%B8_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%B0%D0%BC%D0%B8), но они могут [взаимодействовать с фоновыми скриптами](/ru/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#%D0%92%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B5_%D1%81_%D1%84%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%BC%D0%B8_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%B0%D0%BC%D0%B8), используя систему передачи сообщений, таким образом опосредовано имея доступ ко всему WebExtension API.

> **Примечание:** Обратите внимание, что встраивание скриптов блокируется на следующих доменах:
>
> - accounts-static.cdn.mozilla.net
> - accounts.firefox.com
> - addons.cdn.mozilla.net
> - addons.mozilla.org
> - api.accounts.firefox.com
> - content.cdn.mozilla.net
> - content.cdn.mozilla.net
> - discovery.addons.mozilla.org
> - input.mozilla.org
> - install.mozilla.org
> - oauth.accounts.firefox.com
> - profile.accounts.firefox.com
> - support.mozilla.org
> - sync.services.mozilla.com
> - testpilot.firefox.com
>
> Если вы попытаетесь встроить скрипт на страницы, находящиеся на вышеперечисленных доменах, у вас ничего не выйдет, и веб-страница сделает запись о [CSP](/ru/docs/Web/HTTP/CSP) ошибке.
>
> По причине того, что список запрещённых доменов включает в себя addons.mozilla.org, пользователи, которые попытаются испытать ваше расширение прямо на странице загрузки, могут посчитать, что расширение не работает! В связи с этим вы могли бы предоставить им соответствующее предупреждение или [onboarding page](/ru/docs/Mozilla/Add-ons/WebExtensions/onboarding_upboarding_offboarding_best_practices) чтобы немедленно переадресовать их с addons.mozilla.org.
> **Примечание:** Значения, определённые в глобальной области видимости встраиваемого скрипта с помощью `var foo` или `window.foo = "bar"` могут исчезать по причине бага [1408996](https://bugzilla.mozilla.org/show_bug.cgi?id=1408996).
Обратите внимание, что встраивание скриптов блокируется на следующих доменах:

- accounts-static.cdn.mozilla.net
- accounts.firefox.com
- addons.cdn.mozilla.net
- addons.mozilla.org
- api.accounts.firefox.com
- content.cdn.mozilla.net
- discovery.addons.mozilla.org
- install.mozilla.org
- oauth.accounts.firefox.com
- profile.accounts.firefox.com
- support.mozilla.org
- sync.services.mozilla.com

Если вы попытаетесь встроить скрипт на страницы, находящиеся на вышеперечисленных доменах, у вас ничего не выйдет, и веб-страница сделает запись о [CSP](/ru/docs/Web/HTTP/CSP) ошибке.

> [!NOTE]
> По причине того, что список запрещённых доменов включает в себя addons.mozilla.org, пользователи, которые попытаются испытать ваше расширение прямо на странице загрузки, могут посчитать, что расширение не работает! В связи с этим вы могли бы предоставить им соответствующее предупреждение или [onboarding page](https://extensionworkshop.com/documentation/develop/onboard-upboard-offboard-users/) чтобы немедленно переадресовать их с `addons.mozilla.org`.
## Загрузка встраиваемого скрипта

Expand Down Expand Up @@ -132,7 +128,8 @@ window.confirm("Вы уверены?"); // вызывает оригинальн
]
```

> **Примечание:** Firefox предоставляет некоторое API, позволяющее встраиваемому скрипту иметь доступ к JavaScript объектам, созданным страничным скриптом, и предоставлять свои собственные JavaScript объекты страничному скрипту.
> [!NOTE]
> Firefox предоставляет некоторые API, позволяющие встраиваемому скрипту иметь доступ к JavaScript-объектам, созданным страничным скриптом, и предоставлять свои собственные JavaScript-объекты страничному скрипту.
>
> Смотрите [совместное использование объектов со страничным скриптом](/ru/docs/Mozilla/Add-ons/WebExtensions/Sharing_objects_with_page_scripts) для получения дополнительной информации.
Expand Down Expand Up @@ -171,7 +168,8 @@ window.confirm("Вы уверены?"); // вызывает оригинальн

Встраиваемые скрипты могут делать запросы используя [`window.XMLHttpRequest`](/ru/docs/Web/API/XMLHttpRequest) и [`window.fetch()`](/ru/docs/Web/API/Fetch_API) API.

> **Примечание:** В Firefox, запросы, совершаемые из встраиваемого скрипта (например, используя [fetch()](/ru/docs/Web/API/Fetch_API/Using_Fetch)) происходят в контексте расширения, так что вам необходимо предоставлять полный URL для доступа к контенту страниц. В Chrome, эти запросы совершаются в контексте страницы, так что URL может быть относительным, например `/api` будет трансформирован в `https://[current page URL]/api`.
> [!NOTE]
> В Firefox, запросы, совершаемые из встраиваемого скрипта (например, используя [fetch()](/ru/docs/Web/API/Fetch_API/Using_Fetch)) происходят в контексте расширения, так что вам необходимо предоставлять полный URL для доступа к контенту страниц. В Chrome, эти запросы совершаются в контексте страницы, так что URL может быть относительным, например `/api` будет трансформирован в `https://[current page URL]/api`.
Встраиваемый скрипт имеет точно такие же кросс-доменные привилегии, как и всё остальное расширение: так что если расширение запросило кросс-доменный доступ на какой-либо домен используя [`permissions`](/ru/Add-ons/WebExtensions/manifest.json/permissions) ключ в manifest.json, тогда его встраиваемый скрипт тоже будет иметь доступ к этому домену.

Expand Down Expand Up @@ -371,7 +369,8 @@ window.addEventListener("message", function (event) {
Для просмотра законченного и полностью рабочего примера, [посетите эту страницу на GitHub](https://mdn.github.io/webextensions-examples/content-script-page-script-messaging.html) и следуйте инструкциям.
> **Предупреждение:** Заметьте, при взаимодействии с непроверенными страницами этим способом, вам нужно быть очень осторожными . Расширения имеют возможность запускать привилегированный код, который может обладать серьёзными возможностями, и вредоносные веб-страницы легко могут обмануть ваше расширение, ради доступа к этим возможностям.
> [!WARNING]
> Заметьте, при взаимодействии с непроверенными страницами этим способом, вам нужно быть очень осторожными . Расширения имеют возможность запускать привилегированный код, который может обладать серьёзными возможностями, и вредоносные веб-страницы легко могут обмануть ваше расширение, ради доступа к этим возможностям.
>
> Как простейший пример, представим встраиваемый скрипт, который получает сообщение от веб-страницы и делает что-то вроде этого:
>
Expand Down Expand Up @@ -452,7 +451,8 @@ In page script, window.y: undefined
Те же правила применимы к [`setTimeout()`](/ru/docs/Web/API/setTimeout), [`setInterval()`](/ru/docs/Web/API/setInterval), и [`Function()`](/ru/docs/Web/JavaScript/Reference/Global_Objects/Function).
> **Предупреждение:** Будьте очень осторожны, запуская код в контексте страничного скрипта. Окружение страничного скрипта может контролироваться потенциально зловредным веб-страницей, которая может переопределить объекты, с которыми вы взаимодействуете, так что их поведение станет совершенно непредсказуемым:
> [!WARNING]
> Будьте очень осторожны, запуская код в контексте страничного скрипта. Окружение страничного скрипта может контролироваться потенциально зловредным веб-страницей, которая может переопределить объекты, с которыми вы взаимодействуете, так что их поведение станет совершенно непредсказуемым:
>
> ```js
> // page.js переопределяет console.log
Expand Down
Loading

0 comments on commit dc6c529

Please sign in to comment.