From 9f8f535f3ed7bfe9f0bcd494830782fc9ec23c29 Mon Sep 17 00:00:00 2001 From: Сандро Date: Mon, 18 Oct 2021 13:33:45 +0500 Subject: (ru) Fix Push API page translation (#1358) * Update index.html * Aligned with the English version - Move to Markdown - Fix translation errors * Update index.md Co-authored-by: Sasha Sushko Co-authored-by: Alexey Pyltsyn --- files/ru/web/api/push_api/index.html | 114 ----------------------------------- 1 file changed, 114 deletions(-) delete mode 100644 files/ru/web/api/push_api/index.html (limited to 'files/ru/web/api/push_api/index.html') diff --git a/files/ru/web/api/push_api/index.html b/files/ru/web/api/push_api/index.html deleted file mode 100644 index ce215777d0..0000000000 --- a/files/ru/web/api/push_api/index.html +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: Push API -slug: Web/API/Push_API -tags: - - API - - Ссылка - - Уведомления - - Экспериментальная -translation_of: Web/API/Push_API ---- -

{{DefaultAPISidebar("Push API")}}{{SeeCompatTable}}

- -

Push API даёт веб приложениям возможность получать сообщения отправленные с сервера, независимо от того, запущено ли веб приложение в фоне или даже загружено ли оно вообще пользователем. Это позволяет разработчикам посылать асинхронные сообщения и обновления пользователям которые подписались на них, как результат улучшается информированность пользователей о новом контенте

- -
-

Примечание: Эта документация охватывает спецификацию W3C Push API ; если вы ищете документацию по запатентованной технологии Firefox OS , смотрите здесь.

-
- -

Общие сведения об использовании push уведомлений

- -
-

При внедрении подписки PushManager, жизненно важно защищать запросы от CSRF/XSRF атак в вашем приложении.

- -

Дополнительную информацию см. В следующих статьях:

- - -
- -

Для получения push уведомлений приложение должно иметь активный service worker. Когда service worker активен, оно может подписаться на push уведомления используя {{domxref("PushManager.subscribe()")}}.

- -

Полученный объект {{domxref("PushSubscription")}} включает в себя всю необходимую информацию, которая может потребоваться приложению чтобы отправить push уведомление: адрес и ключ шифрования, необходимые для отправки данных.

- -

Service worker будет запущен для того чтобы обрабатывать входящие push сообщения, которые будут доставлены в {{domxref("ServiceWorkerGlobalScope.onpush")}} обработчик события. Это позволит приложению реагировать на push сообщения, к примеру показывать нотификации через метод {{domxref("ServiceWorkerRegistration.showNotification()")}}.

- -

Каждая подписка уникальна по отношению к service worker. Адрес для подписки это уникальный capability URL: всё что нужно чтобы отослать сообщение вашему приложению это адрес. Однако это URL необходимо держать в секрете, иначе любое другое приложение сможет слать push уведомление к вашему приложению.

- -

Использование service worker для получения push уведомлений может привести к повышенному потреблению ресурсов, например это может влиять на расход батареи. Во всех браузерах это работает по разному - нет стандарта на этот счёт. К примеру Firefox позволяет лишь ограниченное число уведомлений которое может быть отправлено приложению, а Chrome не имеет таких ограничений, однако обязывает показывать уведомление пользователю каждый раз, чтобы пользователь мог решить хочет он или нет принимать их дальше.

- -
-

Примечание: Начиная с Gecko 44, разрешённая квота push-уведомлений для каждого приложения не увеличивается, в случае если новое уведомление срабатывает когда другое все ещё должна отображаться в течение трёх секунд. Это обрабатывает случаи, когда получены несколько Push уведомлений подряд и не все генерируют видимое уведомление.

-
- -
-

Примечание: Так же Chrome обязывает регистрировать проект в Google Cloud Messaging для отправки push сообщений, а также использовать присвоенный номер проекта и API ключ когда отправляются push уведомления. К тому же требуется наличие манифеста приложения с некоторыми параметрами для использования этого сервиса. Возможно эти ограничения будут убраны в будущем.

-
- -

Интерфейсы

- -
-
{{domxref("PushEvent")}}
-
Представляет собой push действие отправленное в global scope {{domxref("ServiceWorker")}}-а. Содержит информацию отправленную в {{domxref("PushSubscription")}}.
-
{{domxref("PushManager")}}
-
Предоставляет способ для получения уведомлений из сторонних серверов, а также из URL запросов для push уведомлений. Этот интерфейс заменил устаревшую функциональность интерфейса {{domxref("PushRegistrationManager")}}.
-
{{domxref("PushMessageData")}}
-
Предоставляет доступ к push данным отправленным сервером и включает методы для манипулирования полученными данными.
-
{{domxref("PushSubscription")}}
-
Предоставляет конечную точку URL подписки и позволяет отписаться от push сервиса.
-
- -

Служебный работник дополнения

- -

Следующие дополнения к Service Worker API описанные в спецификации Push API, представляют собой первостепенные действия для использования Push сообщений, а также для обработки push событий.

- -
-
{{domxref("ServiceWorkerRegistration.pushManager")}} {{readonlyinline}}
-
Возвращает ссылку на интерфейс {{domxref("PushManager")}} для манипулирования push подписок включая подписывание, получение активной подписки и доступ к статусу push разрешения. Это входная точка к обмену push сообщениями.
-
{{domxref("ServiceWorkerGlobalScope.onpush")}}
-
Данный обработчик событий вызывается всякий раз когда происходит событие {{Event("push")}}; то есть всегда когда принимается push сообщение сервера.
-
{{domxref("ServiceWorkerGlobalScope.onpushsubscriptionchange")}}
-
Данный обработчик событий вызывается всякий раз когда происходит событие {{Event("pushsubscriptionchange")}}; например, когда push подписка стала недействительной или собирается быть недействительной (к примеру, когда push сервис устанавливает время истечения.)
-
- -

Спецификации

- - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName("Push API")}}{{Spec2("Push API")}}Initial definition
- -

Совместимость браузера

- -

PushEvent

- -

{{Compat("api.PushEvent")}}

- -

PushMessageData

- -

{{Compat("api.PushMessageData")}}

- -

Смотрите также

- - - -
-
-
-- cgit v1.2.3-54-g00ecf