Начиная с Chrome 122 вы можете подписаться на эксперимент с источником для элемента манифеста приложения scope_extensions, который позволяет представлять сайты, управляющие несколькими субдоменами и доменами верхнего уровня, как одно веб-приложение. В этом документе объясняется, почему команда Chrome вводит эту функцию и когда вы можете захотеть ее использовать.
Обзор
У некоторых веб-приложений есть несколько источников. Например, example.com – это основное приложение, а space_1.example.com, …, space_n.example.com, иногда в сочетании с special-example.com, – это дополнительные источники, которые относятся к основному приложению. Такая архитектура сайта влияет на работу прогрессивных веб-приложений.
Например, нельзя использовать общие сервисные скрипты, устройства, локальные хранилища и разрешения для разных источников. Кроме того, при переходе на другой источник в автономном PWA-приложении появляется окно, сообщающее пользователю, что он покинул приложение. О том, как обойти некоторые из этих проблем, рассказывается в статьях Прогрессивные веб-приложения на сайтах с несколькими источниками и Создание нескольких прогрессивных веб-приложений в одном домене.
Scope Extensions API позволяет веб-приложениям преодолеть некоторые проблемы, которые правило ограничения домена накладывает на такую архитектуру сайтов. Она позволяет веб-приложениям расширять свою область действия на другие источники, чтобы обеспечить единообразие работы. Для этого требуется согласие между основным источником веб-приложения и связанными источниками.
Цели
Основная цель Scope Extensions API – позволить сайтам, которые управляют несколькими субдоменами и доменами верхнего уровня, вести себя как одно непрерывное веб-приложение, когда дело доходит до пользовательского интерфейса веб-приложения и захвата ссылок. Например, сайт example.com, который охватывает example.com.co.uk и support.example.com, может работать как единое веб-приложение.

Расширения области действия позволяют PWA с несколькими источниками работать как единое веб-приложение, когда речь идет об интерфейсе.
На практике это означает две более конкретные цели:
- Перекрестная навигация. Пользователи могут переходить между связанными источниками, не прерывая работу с приложением. При этом появляется окно с информацией о том, что они покидают PWA.
- Перехват ссылок из разных источников. Веб-приложения могут перехватывать переходы пользователей на связанные сайты.
Перекрестная навигация в области действия
По умолчанию, когда пользователи перемещаются между источниками в автономном PWA, им показывается окно пользовательского интерфейса, указывающее, что они выходят за пределы PWA. В Chrome этот интерфейс состоит из панели "вне области действия", которая содержит URL нового источника. Это мешает пользователям, поскольку они ожидают, что продолжат навигацию в том же приложении, но могут почувствовать, что их уводят из него.

Панель "За пределами области действия", которая показывается в Chrome, когда пользователи переходят между разными источниками в отдельном PWA.
При использовании расширений области действия интерфейс окна не будет показываться, когда пользователи переходят к любому из связанных источников, поэтому PWA будет выглядеть как единое целое.
Перехват ссылок из разных источников
Захват ссылок – это способность приложения захватывать ссылки в пределах своей области действия. Реализация этого механизма зависит от браузера и операционной системы. Например, в Chrome на ChromeOS ссылки в области действия установленного PWA по умолчанию открывают вкладку браузера с указанием в адресной строке, что есть приложение, способное обрабатывать эти ссылки, что позволяет пользователю выбрать автоматический захват ссылок с этого момента.

Фрагмент адресной строки Chrome для вкладки в ChromeOS с визуальным индикатором того, что ссылка может быть обработана PWA, и возможностью запомнить это решение.
Если пользователь нажмет на ссылку, которая не относится к PWA (в том числе на ссылку на субдомен или домен верхнего уровня), он не будет распознан как принадлежащий к нему. Например, ссылки будут открываться на вкладке браузера без уведомления пользователя о том, что есть приложение, способное обработать ссылку. Scope Extensions API позволяет расширить область действия PWA, чтобы связанные источники обрабатывались как ссылки в области действия.
Реализация
Чтобы реализовать расширения области действия, необходимо установить связь между основным источником и связанными источниками.
Объявите список связанных источников
Добавьте элемент манифеста веб-приложения scope_extensions в основной источник PWA, чтобы расширить область действия веб-приложения на другие источники.
Манифест веб-приложения (https://example.com)
{
"id": "/",
"name": "Example",
"display": "standalone",
"start_url": "/index.html",
"scope_extensions": [
{ "type": "origin", "origin": "https://help.example.com" },
{ "type": "origin", "origin": "https://example.co.uk" },
{ "type": "origin", "origin": "https://help.example.co.uk" }
]
}
Подтвердите связи
Каждый из перечисленных источников подтверждает связь с веб-приложением с помощью файла конфигурации /.well-known/web-app-origin-association. Файл должен называться web-app-origin-association и находиться именно в этом месте, поскольку это общеизвестный URI.
/.well-known/web-app-origin-association (связанный источник)
{
"https://example.com/": {
"scope": "/"
}
}
В файле перечислены веб-приложения, с которыми связан источник. Каждый ключ – это идентификатор манифеста веб-приложения, а каждое значение может задавать необязательную область действия, которая относится к связанному источнику. Если вы не укажете область действия, по умолчанию будет использоваться "/".
Демоверсии
Демонстрация состоит из двух сайтов:
- Основное PWA. Фактическое PWA, которое объявляет список связанных источников через элемент
scope_extensionsв манифесте веб-приложения. - Источник в расширенной области действия. Источник, который находится за пределами основной области действия PWA, но связан с ней, поскольку указан в основном PWA как связанный источник и подтвердил связь через свой файл
web-app-origin-association.
Чтобы выполнить следующие тесты, необходимо включить параметр about://flags/#enable-desktop-pwas-scope-extensions (доступен в Chrome 115 и более поздних версиях).
Как протестировать междоменную навигацию
Чтобы выполнить эти тесты, откройте основное PWA в браузере, установите его как PWA и запустите в автономном режиме. В PWA есть ссылки на источник в расширенной области действия и на источник вне расширенной области действия.

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

Панель "Вне области действия", которая по умолчанию показывается при переходе между источниками в PWA в автономном режиме.
Перекрестная навигация с расширениями области действия (в расширенной области действия)
- Вернитесь на главную страницу PWA.
- Нажмите на ссылку Источник не входит в расширенную область действия.
- По умолчанию должна показываться панель "Вне области действия", но из-за связи с расширениями области действия она не показывается.

Панель "Вне области действия" не показывается при перекрестной навигации после того, как источник был связан с расширениями области действия.
Тестирование перехвата ссылок из разных источников
- Откройте и установите основное прогрессивное веб-приложение на устройстве с ChromeOS.
- Нажмите на ссылку связанный источник.
- Ссылка открывается в новой вкладке браузера, и пользователю предлагается открыть ее в установленном PWA.

При нажатии на ссылку, связанную с источником PWA, она открывается в новой вкладке и появляется значок "Открыть в приложении", позволяющий пользователю включить автоматический перехват ссылок.
Эксперимент с источником
Если вы хотите протестировать этот API в своем приложении на реальных пользователях, вы можете сделать это с помощью эксперимента с источником. Эксперименты с источником позволяют тестировать экспериментальные функции с участием пользователей. Для этого нужно получить токен тестирования, связанный с вашим доменом. Затем вы можете развернуть свое приложение и ожидать, что оно будет работать в браузере, поддерживающем тестируемую вами функцию (в данном случае она доступна в Chrome с 121 по 126). Чтобы получить собственный токен для проведения эксперимента с источником, заполните форму заявки.
Как оставить отзыв
Команда Chrome ждет отзывов о полезности этого API. Чтобы помочь команде разработчиков улучшить этот API, вы можете оставить отзыв о его полезности и новых сценариях использования, не предусмотренных в текущей версии. Для этого создайте тему на GitHub.
Дополнительные ресурсы
- Scope Extensions API – эксперимент с источником
- Chrome Status – расширения области действия веб-приложений
- Расширения области действия для веб-приложений
- Intent to Experiment (Намерение провести эксперимент)
- Позиция Mozilla в отношении стандартов
- Позиция Apple в отношении стандартов
- Ошибка Chromium
- Прогрессивные веб-приложения на сайтах с несколькими источниками
- Создание нескольких прогрессивных веб-приложений в одном домене
Благодарности
Особая благодарность команде, которая разработала этот API. Расширения области действия были разработаны Аланом Каттером (Alan Cutter) и Лу Хуаном (Lu Huang) при участии Мэтта Джуки (Matt Giuca). API реализовали Алан Каттер (Alan Cutter) из Google Chrome, а также Хассан Талат (Hassan Talat), Кристин Ли (Kristin Lee) и Лу Хуан (Lu Huang) из Microsoft Edge.