url_handlers

Używane przez aplikacje w pakiecie do określania wzorców adresów URL, które aplikacja ma przechwytywać i obsługiwać. W ramach tego wpisu z plikiem manifestu aplikacja może zdefiniować wiele modułów obsługi adresów URL. Każdy z nich ma identyfikator, wzorzec adresu URL i tytuł. Oto przykład, jak określić właściwość url_handlers:

"url_handlers": {
  "view_foo_presentation": {
    "matches": [
      "https://www.foo.com/presentation/view/*"
    ],
    "title": "View Foo presentation"
  },
  "view_bar_presentation": {
    "matches": [
      "https://www.bar.com/view/slideshow/*"
    ],
    "title": "View bar presentation"
  },
  "edit_spreadsheet": {
    "matches": [
      "https://www.foo.com/spreadsheet/edit/*",
      "https://www.bar.com/spreadsheet/edit/*"
    ],
    "title": "Edit spreadsheet"
  }
}

Aplikacje mogą się rejestrować w celu obsługi wzorców adresów URL tylko w należących do nich domenach, czyli mogących potwierdzić własność witryny zgodnie z ustaleniami Chrome Web Store. Aplikacje, które naruszą ten wymóg i podejmą próbę zarejestrowania się w celu obsługi zewnętrznych adresów URL, zostaną odrzucone przez Chrome Web Store po przesłaniu.

Automatycznie oznacza to, że zawsze należy określić co najmniej pełną domenę dla wszystkich wzorców w matches. W przeciwnym razie nie można zweryfikować własności.

Po zarejestrowaniu i zainstalowaniu aplikacja zostanie uruchomiona dla wszystkich pasujących elementów nawigacyjnych na kartach przeglądarki oraz w innych aplikacjach. Aplikacja otrzyma nowy rodzaj zdarzenia app.runtime.onLaunched z obiektem launchData zawierającym identyfikator dopasowanego modułu obsługi (np. „view_foo_presentation” powyżej), adres URL, do którego prowadzi adres URL, i adres URL strony odsyłającej.

Pole title jest zarezerwowane do użycia w przyszłości we wszystkich odpowiednich elementach interfejsu. Powinien zawierać opis działania wykonywanego przez aplikację po uruchomieniu tego typu modułu obsługi adresów URL.