Skip to content
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

[ru] unify the use of WebExtension-related terms #16876

Merged
merged 16 commits into from
Dec 11, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
2aaf759
[ru]: fix links on /ru/docs/Mozilla/Add-ons/WebExtensions/Your_first_…
leon-win Nov 4, 2023
878ce16
[ru]: update /ru/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExt…
leon-win Nov 4, 2023
512b666
Merge branch 'main' into fix/13334/docs-mozilla-add-ons-web-extensions
leon-win Nov 6, 2023
ffbff65
Merge branch 'main' into fix/13334/docs-mozilla-add-ons-web-extensions
leon-win Nov 8, 2023
64872c2
[ru]: update usage of WebExtension-related terms
leon-win Nov 8, 2023
b7c1416
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Nov 8, 2023
6024806
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Nov 14, 2023
72c9894
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Nov 15, 2023
3638cd8
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Nov 18, 2023
3e8bc2a
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Nov 21, 2023
9150d0d
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Nov 25, 2023
c7cc632
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Nov 28, 2023
2d3134c
[ru] fix 'Mozilla/Add-ons/WebExtensions' translation
leon-win Dec 3, 2023
fb175ed
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Dec 3, 2023
a8d100c
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Dec 4, 2023
2ad3a83
Merge branch 'main' into update/docs-mozilla-add-ons-web-extensions
leon-win Dec 5, 2023
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
Original file line number Diff line number Diff line change
Expand Up @@ -592,7 +592,7 @@ video.onclick = function (e) {

Это все, что вам нужно знать о веб-событиях на этом этапе. Как уже упоминалось, события не являются частью основного JavaScript — они определены в веб-интерфейсах браузера ([Web API](/ru/docs/Web/API)).

Кроме того, важно понимать, что различные контексты, в которых используется JavaScript, обычно имеют разные модели событий — от веб-API до других областей, таких как браузерные WebExtensions и Node.js (серверный JavaScript). Может сейчас вы не особо в этом разбираетесь, но по мере изучения веб-разработки начнёт приходить более ясное понимание тематики.
Кроме того, важно понимать, что различные контексты, в которых используется JavaScript, обычно имеют разные модели событий — от веб-API до других областей, таких как браузерные расширения и Node.js (серверный JavaScript). Может сейчас вы не особо в этом разбираетесь, но по мере изучения веб-разработки начнёт приходить более ясное понимание тематики.

Если у вас возникли вопросы, попробуйте прочесть статью снова или [обратитесь за помощью к нам](/ru/docs/Learn#Contact_us).

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Анатомия Расширения
title: Внутреннее устройство расширения
slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension
---

Expand Down Expand Up @@ -75,7 +75,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension

Фоновые скрипты запускаются в пространстве специальной страницы, называемой фоновой. Это даёт им доступ к глобальному [`window`](/ru/docs/Web/API/Window) объекту, а так же ко всем его DOM APIs.

#### WebExtension APIs
#### WebExtension API

Фоновые скрипты могут использовать любые [API расширений](/ru/docs/Mozilla/Add-ons/WebExtensions/API), если расширение имеет необходимые [разрешения](/ru/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions).

Expand All @@ -101,11 +101,11 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension

Для каждого из этих компонентов вы создаёте HTML файл и помещаете специальную информацию в [manifest.json](/ru/docs/Mozilla/Add-ons/WebExtensions/manifest.json). HTML файл может в себя включать CSS и JavaScript файлы, как и любая web-страница.

Всё это типы [веб-страниц расширения](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Extension_pages), и, в отличие от нормальных веб-страниц, ваш JavaScript может использовать все привелегии WebExtension APIs, как и ваши фоновые скрипты. Они даже могут получить доступ к переменным в фоновой странице, используя {{WebExtAPIRef("runtime.getBackgroundPage()")}}.
Всё это типы [веб-страниц расширения](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Extension_pages), и, в отличие от нормальных веб-страниц, ваш JavaScript может использовать все привелегии WebExtension API, как и ваши фоновые скрипты. Они даже могут получить доступ к переменным в фоновой странице, используя {{WebExtAPIRef("runtime.getBackgroundPage()")}}.

## Веб-страницы расширения

Вы также можете включить HTML документы в ваше расширение, даже если они не будут включены в какой-либо существующий компонент пользовательского интерфейса. В отличие от документов, которые вы можете предоставить для боковых панелей, всплывающих окон или страниц настроек, эти документы не содержатся в manifest.json. Однако, они также имеют такой же доступ к WebExtension APIs, как и фоновые скрипты.
Вы также можете включить HTML документы в ваше расширение, даже если они не будут включены в какой-либо существующий компонент пользовательского интерфейса. В отличие от документов, которые вы можете предоставить для боковых панелей, всплывающих окон или страниц настроек, эти документы не содержатся в manifest.json. Однако, они также имеют такой же доступ к WebExtension API, как и фоновые скрипты.

Вы можете загрузить такую страницу, используя {{WebExtAPIRef("windows.create()")}} или {{WebExtAPIRef("tabs.create()")}}.

Expand All @@ -123,7 +123,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension

- Осуществлять XHR запросы.
- Использовать часть [API расширений](/ru/docs/Mozilla/Add-ons/WebExtensions/API).
- Обмениваться сообщениями с их фоновыми скриптами и таким образом иметь доступ ко всему WebExtension APIs.
- Обмениваться сообщениями с их фоновыми скриптами и таким образом иметь доступ ко всему WebExtension API.

Встраиваемые скрипты не могут напрямую взаимодействовать с обычными скриптами на странице, но они могут обмениваться сообщениями с помощью стандартного [`window.postMessage()`](/ru/docs/Web/API/Window/postMessage) API.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Mozilla/Add-ons/WebExtensions/API/cookies

{{AddonSidebar}}

Позволяет WebExtensions получить и установить куки ,а также сообщить об их изменении.
Позволяет расширениям получать и устанавливать куки, а также сообщать об их изменении.

Для использования этого API,вам нужно предоставить доступ [API permission](/en-US/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) в вашем файле [manifest.json](/ru/docs/Mozilla/Add-ons/WebExtensions/manifest.json),а также [host permissions](/en-US/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) для тех сайтов чьи куки вам нужны для доступа.Смотрите [cookie Permissions](/en-US/Add-ons/WebExtensions/API/cookies#Permissions).

Expand Down
4 changes: 2 additions & 2 deletions files/ru/mozilla/add-ons/webextensions/api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Mozilla/Add-ons/WebExtensions/API

{{AddonSidebar}}

WebExtension JavaScript API может быть использован в [фоновых скриптах](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#%D0%A4%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B) расширения, а так же в любых других документах, поставляемых вместе с расширением, таких как документы во всплывающих окнах после нажатия кнопок активации расширения [browser action](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_action)на панели инструментов или [page action](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Page_actions) в строке адреса, [боковой панели](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Sidebars), [страницах настроек](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Options_pages) или [новых открытых вкладках](/ru/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides). Некоторые из этих API могут быть доступны на [встраиваемых в страницу скриптах](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#%D0%92%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B) (см. [список в руководстве по встраиваемым скриптам](/ru/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#WebExtension_APIs)).
JavaScript WebExtension API может быть использован в [фоновых скриптах](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#%D0%A4%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B) расширения, а так же в любых других документах, поставляемых вместе с расширением, таких как документы во всплывающих окнах после нажатия кнопок активации расширения [browser action](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_action)на панели инструментов или [page action](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Page_actions) в строке адреса, [боковой панели](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Sidebars), [страницах настроек](/ru/docs/Mozilla/Add-ons/WebExtensions/user_interface/Options_pages) или [новых открытых вкладках](/ru/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides). Некоторые из этих API могут быть доступны на [встраиваемых в страницу скриптах](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#%D0%92%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B) (см. [список в руководстве по встраиваемым скриптам](/ru/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#WebExtension_API)).

Для использования отдельных более продвинутых API, необходимо [запросить разрешения](/ru/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) в manifest.json вашего дополнения.

Expand Down Expand Up @@ -36,7 +36,7 @@ setCookie.then(logCookie, logError);

Обратите внимание, что это отличается от расширений Google Chrome, которые используют пространство имён `chrome` вместо `browser` и колбэки для асинхронных функций вместо промисов.

Для поддержки портирования, реализация Firefox WebExtensions API так же поддерживает пространство имён `chrome` и использование колбэков. Это позволяет в большинстве случаев не изменять код, изначально написанный для Chrome.
Для поддержки портирования, реализация Firefox WebExtension API так же поддерживает пространство имён `chrome` и использование колбэков. Это позволяет в большинстве случаев не изменять код, изначально написанный для Chrome.

Mozilla так же предоставляет полифил, который позволяет коду, использующему `browser` и промисы, работать без изменений в Chrome: <https://github.com/mozilla/webextension-polyfill>.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: Mozilla/Add-ons/WebExtensions/Content_scripts

Встраиваемый скрипт - это часть расширения, которая выполняется в контексте отдельной веб-страницы (в отличии от фоновых скриптов, выполняющихся в контексте целого браузера).

[Фоновые скрипты](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#%D0%A4%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B) имеют доступ ко всем методам [WebExtension JavaScript APIs](/ru/docs/Mozilla/Add-ons/WebExtensions/API), но они не имеют доступа к контенту отдельных веб-страниц. Так что если вашему расширению необходимо взаимодействие с контентом веб-страницы, вам нужен встраиваемый скрипт.
[Фоновые скрипты](/ru/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#%D0%A4%D0%BE%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D1%8B) имеют доступ ко всем методам [WebExtension API](/ru/docs/Mozilla/Add-ons/WebExtensions/API), но они не имеют доступа к контенту отдельных веб-страниц. Так что если вашему расширению необходимо взаимодействие с контентом веб-страницы, вам нужен встраиваемый скрипт.

Точно так же, как скрипты загружаемые веб-страницами, встраиваемый скрипт может читать и изменять контент веб-страницы, используя DOM API.

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

### Доступные WebExtension API

В дополнение стандартному DOM API, встраиваемый скрипт может использовать следующие методы WebExtension APIs:
В дополнение стандартному DOM API, встраиваемый скрипт может использовать следующие методы WebExtension API:

Из [`extension`](/ru/Add-ons/WebExtensions/API/extension):

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

## Взаимодействие с фоновыми скриптами

Хотя встраиваемые скрипты не могут напрямую использовать большинство методов из WebExtension APIs, они могут взаимодействовать с фоновыми скриптами расширения, используя систему сообщений, и таким образом могут опосредованно иметь доступ к тем же самым API, что и фоновые скрипты.
Хотя встраиваемые скрипты не могут напрямую использовать большинство методов из WebExtension API, они могут взаимодействовать с фоновыми скриптами расширения, используя систему сообщений, и таким образом могут опосредованно иметь доступ к тем же самым API, что и фоновые скрипты.

Существует два способа общения между фоновым и встраиваемым скриптами: вы можете посылать одиночные сообщения, ожидая необязательного ответа, или вы можете установить долгосрочное соединение на двух сторонах и использовать это соединение для обмена сообщениями.

Expand Down
2 changes: 1 addition & 1 deletion files/ru/mozilla/add-ons/webextensions/examples/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Mozilla/Add-ons/WebExtensions/Examples

{{AddonSidebar}}

В целях иллюстрации разработки расширений, мы поддерживаем репозиторий простых демонстрационных расширений по адресу <https://github.com/mdn/webextensions-examples>. Данная статья описывает, как использовать эти примеры, и перечисляет их вместе с API Веб-расширений (WebExtensions API), которые они демонстрируют.
В целях иллюстрации разработки расширений, мы поддерживаем репозиторий простых демонстрационных расширений по адресу <https://github.com/mdn/webextensions-examples>. Данная статья описывает, как использовать эти примеры, и перечисляет их вместе с WebExtension API, которые они демонстрируют.

Эти примеры работают в Firefox Nightly: большинство из них работает и в более ранних версиях Firefox, но, чтобы удостовериться, проверьте поле [strict_min_version](/en-US/Add-ons/WebExtensions/manifest.json/applications) в файле manifest.json.

Expand Down
Loading