chrome.webviewTag

Opis

Używaj tagu webview, aby aktywnie wczytywać treści opublikowane z internetu przez sieć i umieścić je w aplikacji Chrome. Aplikacja może kontrolować wygląd interfejsu webview, wchodzić w interakcje z treściami internetowymi, inicjować nawigację na umieszczonej stronie internetowej oraz reagować na występujące w niej zdarzenia błędów (patrz Użycie).

Uprawnienia

webview

Typy

ClearDataOptions

Opcje określające, które dane powinny zostać wyczyszczone przez clearData.

Właściwości

  • od

    liczba opcjonalnie

    Wyczyść dane zgromadzone w tym dniu lub później, wyrażone w milisekundach od początku epoki (dostępne za pomocą metody getTime obiektu JavaScript Date). Jeśli nie określono tego atrybutu, domyślnie przyjmuje on wartość 0 (co powoduje usunięcie wszystkich danych przeglądania).

ClearDataTypeSet

Zbiór typów danych. Brakujące właściwości są interpretowane jako false.

Właściwości

  • pamięć podręczna aplikacji

    Wartość logiczna opcjonalna

    Witryny pamięci podręcznej aplikacji.

  • Pamięć podręczna

    Wartość logiczna opcjonalna

    Chrome w wersji 44 lub nowszej .

    Od wersji Chrome 43. Pamięć podręczna przeglądarki. Uwaga: usunięcie danych powoduje wyczyszczenie całej pamięci podręcznej. nie jest ograniczony do wskazanego przez Ciebie zakresu.

  • ciastka

    Wartość logiczna opcjonalna

    Pliki cookie partycji.

  • fileSystems

    Wartość logiczna opcjonalna

    Witryny systemów plików.

  • indexedDB

    Wartość logiczna opcjonalna

    Witryny Dane IndexedDB.

  • localStorage

    Wartość logiczna opcjonalna

    Witryny pamięci lokalnej.

  • persistentCookies

    Wartość logiczna opcjonalna

    Chrome w wersji 58 lub nowszej .

    Trwałe pliki cookie partycji.

  • sessionCookies

    Wartość logiczna opcjonalna

    Chrome w wersji 58 lub nowszej .

    Pliki cookie sesji partycji.

  • webSQL

    Wartość logiczna opcjonalna

    Witryny danych WebSQL.

ContentScriptDetails

Chrome w wersji 44 lub nowszej .

Szczegóły skryptu treści do wstawienia. Więcej informacji znajdziesz w dokumentacji skryptów treści.

Właściwości

  • all_frames

    Wartość logiczna opcjonalna

    Jeśli all_frames to true, oznacza to, że we wszystkich ramkach bieżącej strony należy wstawić JavaScript lub CSS. Domyślnie all_frames to false, a JavaScript lub CSS jest wstrzykiwany tylko w górnej ramce.

  • css

    Opcjonalny InjectionItems

    Kod CSS lub lista plików CSS do wstrzykiwania na pasujących stronach. Są one wstrzykiwane w kolejności, w jakiej występują, przed utworzeniem lub wyświetleniem DOM strony.

  • exclude_globs

    string[] opcjonalnie

    Stosowane po dopasowaniu, aby wykluczyć adresy URL pasujące do tego glob. Służy do emulacji słowa kluczowego @excluded Greasemonkey.

  • exclude_matches

    string[] opcjonalnie

    Nie obejmuje stron, na których ten skrypt treści zostałby wstrzykiwany.

  • include_globs

    string[] opcjonalnie

    Jest stosowana po dopasowaniu, aby uwzględnić tylko te adresy URL, które również pasują do tego glob. Służy do emulacji słowa kluczowego @include Greasemonkey.

  • JS

    Opcjonalny InjectionItems

    Kod JavaScript lub lista plików JavaScript do wstrzykiwania na pasujących stronach. Są one wstrzykiwane w kolejności, w jakiej się pojawiają.

  • match_about_blank

    Wartość logiczna opcjonalna

    Określa, czy skrypt dotyczący treści ma być wstawiony w parametrach about:blank i about:srcdoc. Skrypty treści będą wstrzykiwane na stronach tylko wtedy, gdy ich dziedziczony adres URL zostanie dopasowany do jednego z zadeklarowanych wzorców w polu dopasowań. Dziedziczony URL to adres URL dokumentu, w którym ramka lub okno zostało utworzone. Nie można wstawiać skryptów treści w ramkach piaskownicy.

  • pasuje do

    ciąg znaków[]

    Określa strony, na których ten skrypt treści będzie wstrzykiwany.

  • nazwa

    ciąg znaków

    Nazwa skryptu treści do wstawienia.

  • run_at

    Opcjonalnie RunAt

    Najszybszym wstrzykiwaniem kodu JavaScript lub CSS do karty. Domyślna wartość to „document_idle”.

ContentWindow

Uchwyt wiadomości do okna gościa.

Właściwości

  • postMessage

    nieważne

    Publikuje wiadomość w umieszczonej treści internetowej, o ile tylko wyświetla ona stronę z docelowego źródła. Ta metoda jest dostępna po zakończeniu wczytywania strony. Wykryj zdarzenie contentload, a następnie wywołaj metodę.

    Gość będzie mógł wysyłać odpowiedzi do umieszczonej treści, publikując wiadomość na adres event.source w otrzymanym wydarzeniu.

    Ten interfejs API nie różni się od interfejsu HTML5 postMessage API do komunikacji między stronami internetowymi. Umieszczający kod może nasłuchiwać odpowiedzi, dodając do własnej ramki detektor zdarzeń message.

    Funkcja postMessage wygląda tak:

    (message: any, targetOrigin: string) => {...}

    • wiadomość

      każdy

      Obiekt wiadomości do wysłania do gościa.

    • targetOrigin

      ciąg znaków

      Określa, jakie musi być źródło okna gościa, aby można było wysłać zdarzenie.

ContextMenuCreateProperties

Chrome w wersji 44 lub nowszej .

Właściwości

  • zaznaczono

    Wartość logiczna opcjonalna

    Początkowy stan pola wyboru lub elementu opcji: true (prawda) w przypadku zaznaczonych elementów i fałsz – jeśli nie są zaznaczone. W danej grupie elementów radiowych można w danym momencie wybrać tylko 1 element opcji.

  • konteksty

    [ContextType, ...ContextType[]] opcjonalny

    Lista kontekstów, w których będzie się wyświetlać ten element menu. Jeśli nie zostanie podany, domyślna wartość to ['strona'].

  • documentUrlPatterns

    string[] opcjonalnie

    Pozwala ograniczyć zastosowanie elementu tylko do dokumentów, których adres URL pasuje do jednego z podanych wzorców. (Dotyczy to również ramek). Szczegółowe informacje o formacie wzorca znajdziesz w artykule Wzorce dopasowania.

  • włączone

    Wartość logiczna opcjonalna

    Określa, czy ta pozycja menu kontekstowego jest włączona czy wyłączona. Domyślna wartość to true.

  • id

    ciąg znaków opcjonalny

    Unikalny identyfikator do przypisania do tego elementu. Obowiązkowy na stronach wydarzeń. Nie może być taki sam jak inny identyfikator tego rozszerzenia.

  • parentId

    string | liczba opcjonalnie

    identyfikator nadrzędnej pozycji menu; element ten staje się elementem podrzędnym elementu dodanego wcześniej.

  • targetUrlPatterns

    string[] opcjonalnie

    Działa podobnie do documentUrlPatterns, ale pozwala filtrować na podstawie atrybutu src tagów img/audio/video i href tagów kotwicy.

  • tytuł

    ciąg znaków opcjonalny

    Tekst do wyświetlenia w produkcie. jest wymagany, chyba że „type” jest „separatorem”. Gdy kontekst to „wybór”, możesz użyć w ciągu znaków %s, aby wyświetlić zaznaczony tekst. Jeśli na przykład wartość tego parametru to „Przetłumacz '%s” po „Pig Latin” a użytkownik wybiera słowo „świetne”, co zostaje w menu kontekstowym jako „Przetłumacz „świetne” Pig Latin”.

  • typ

    Opcjonalny ItemType

    Typ elementu menu. Domyślna wartość to „normal” jeśli nie określono żadnej wartości.

  • Kliknij

    void opcjonalnie

    Funkcja, która jest wywoływana po kliknięciu elementu menu.

    Funkcja onclick wygląda tak:

    (info: OnClickData) => {...}

    • informacje

      Informacje o klikniętym produkcie i kontekście kliknięcia.

ContextMenus

Chrome w wersji 44 lub nowszej .

Właściwości

  • onShow

    Zdarzenie<functionvoid>

    Uruchamiane przed wyświetleniem menu kontekstowego w: webview. Można użyć do wyłączenia tego menu kontekstowego, wywołując funkcję event.preventDefault().

    Funkcja onShow.addListener wygląda tak:

    (callback: function) => {...}

    • wywołanie zwrotne

      funkcja

      Parametr callback wygląda tak:

      (event: object) => void

      • event

        Obiekt

        • preventDefault

          nieważne

          Wywołuj je, by zapobiec wyświetlaniu menu kontekstowego.

          Funkcja preventDefault wygląda tak:

          () => {...}

  • utwórz

    nieważne

    Tworzy nową pozycję w menu kontekstowym. Pamiętaj, że jeśli podczas tworzenia wystąpi błąd, możesz nie wiedzieć, dopóki nie uruchomi się wywołanie zwrotne tworzenia (szczegóły znajdziesz w runtime.lastError).

    Funkcja create wygląda tak:

    (createProperties: object, callback?: function) => {...}

    • createProperties

      Obiekt

      Właściwości użyte do utworzenia elementu

    • wywołanie zwrotne

      funkcja optional

      Parametr callback wygląda tak:

      () => void

    • returns

      string | numer

      Identyfikator nowo utworzonego elementu.

  • usuń

    nieważne

    Usuwa pozycję menu kontekstowego.

    Funkcja remove wygląda tak:

    (menuItemId: string | number, callback?: function) => {...}

    • menuItemId

      string | numer

      Identyfikator elementu menu kontekstowego, który ma zostać usunięty.

    • wywołanie zwrotne

      funkcja optional

      Parametr callback wygląda tak:

      () => void

  • usuń wszystko

    nieważne

    Usuwa wszystkie pozycje menu kontekstowego dodane do tego elementu (webview).

    Funkcja removeAll wygląda tak:

    (callback?: function) => {...}

    • wywołanie zwrotne

      funkcja optional

      Parametr callback wygląda tak:

      () => void

  • update

    nieważne

    Aktualizuje wcześniej utworzony element menu kontekstowego.

    Funkcja update wygląda tak:

    (id: string | number, updateProperties: object, callback?: function) => {...}

    • id

      string | numer

      Identyfikator elementu do zaktualizowania.

    • updateProperties

      Obiekt

      Właściwości do zaktualizowania. Akceptuje te same wartości co funkcja tworzenia.

    • wywołanie zwrotne

      funkcja optional

      Parametr callback wygląda tak:

      () => void

ContextMenuUpdateProperties

Chrome w wersji 44 lub nowszej .

Właściwości

  • zaznaczono

    Wartość logiczna opcjonalna

    Stan pola wyboru lub opcji: true (prawda) – zaznaczone, i fałsz – niezaznaczone. W danej grupie elementów radiowych można w danym momencie wybrać tylko 1 element opcji.

  • konteksty

    [ContextType, ...ContextType[]] opcjonalny

    Lista kontekstów, w których będzie się wyświetlać ten element menu.

  • documentUrlPatterns

    string[] opcjonalnie

    Pozwala ograniczyć zastosowanie elementu tylko do dokumentów, których adres URL pasuje do jednego z podanych wzorców. (Dotyczy to również ramek). Szczegółowe informacje o formacie wzorca znajdziesz w artykule Wzorce dopasowania.

  • włączone

    Wartość logiczna opcjonalna

    Określa, czy ta pozycja menu kontekstowego jest włączona czy wyłączona.

  • parentId

    string | liczba opcjonalnie

    identyfikator nadrzędnej pozycji menu; element ten staje się elementem podrzędnym elementu dodanego wcześniej. Uwaga: nie możesz zmienić elementu na element podrzędny jednego z jego elementów podrzędnych.

  • targetUrlPatterns

    string[] opcjonalnie

    Działa podobnie do documentUrlPatterns, ale pozwala filtrować na podstawie atrybutu src tagów img/audio/video i href tagów kotwicy.

  • tytuł

    ciąg znaków opcjonalny

    Tekst do wyświetlenia w elemencie

  • typ

    Opcjonalny ItemType

    Typ elementu menu.

  • Kliknij

    void opcjonalnie

    Funkcja, która jest wywoływana po kliknięciu elementu menu.

    Funkcja onclick wygląda tak:

    (info: OnClickData) => {...}

    • informacje

      Informacje o klikniętym produkcie i kontekście kliknięcia.

ContextType

Chrome w wersji 44 lub nowszej .

w różnych kontekstach, w których może się pojawiać menu; Określanie wszystkich jest odpowiednikiem kombinacji wszystkich innych kontekstów.

Typ wyliczeniowy

"all"

"strona"

"frame"

"selection"

"link"

"edycja"

"image"

"video"

"audio"

DialogController

Interfejs został dołączony do dialog zdarzeń DOM.

Właściwości

  • anuluj

    nieważne

    Odrzuć okno. Odpowiednik kliknięcia Anuluj w oknie confirm lub prompt.

    Funkcja cancel wygląda tak:

    () => {...}

  • OK

    nieważne

    Zaakceptuj okno. Odpowiednik kliknięcia OK w oknie alert, confirm lub prompt.

    Funkcja ok wygląda tak:

    (response?: string) => {...}

    • odpowiedź

      ciąg znaków opcjonalny

      Ciąg znaków odpowiedzi, który należy przekazać gościowi podczas akceptowania okna prompt.

DownloadPermissionRequest

Typ obiektu request towarzyszącego zdarzeniu DOM download permissionrequest.

Właściwości

  • requestMethod

    ciąg znaków

    Typ żądania HTTP (np. GET) powiązany z żądaniem pobierania.

  • URL

    ciąg znaków

    Żądany URL pobierania.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa allow nie jest wywoływana.

    Funkcja deny wygląda tak:

    () => {...}

FileSystemPermissionRequest

Typ obiektu request towarzyszącego zdarzeniu DOM filesystem permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki żądającej dostępu do lokalnego systemu plików.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia,

    Funkcja deny wygląda tak:

    () => {...}

FindCallbackResults

Zawiera wszystkie wyniki żądania.

Właściwości

  • activeMatchOrdinal

    liczba

    Liczba porządkowa bieżącego dopasowania.

  • anulowano

    wartość logiczna

    Wskazuje, czy to żądanie wyszukiwania zostało anulowane.

  • numberOfMatches

    liczba

    Liczba dopasowań na stronie (searchText).

  • selectionRect

    Opisuje prostokąt wokół aktywnego dopasowania we współrzędnych ekranu.

FindOptions

Opcje żądania znalezienia.

Właściwości

  • do tyłu

    Wartość logiczna opcjonalna

    Oznacz, by znaleźć dopasowania w odwrotnej kolejności. Wartością domyślną jest false.

  • matchCase

    Wartość logiczna opcjonalna

    Oznacz zgodnie z uwzględnieniem wielkości liter. Wartością domyślną jest false.

FullscreenPermissionRequest

Chrome w wersji 43 lub nowszej .

Typ obiektu request towarzyszącego zdarzeniu DOM fullscreen permissionrequest.

Właściwości

  • pochodzenie

    ciąg znaków

    Źródło ramki w elemencie webview, które zainicjowało żądanie pełnego ekranu.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia,

    Funkcja deny wygląda tak:

    () => {...}

GeolocationPermissionRequest

Typ obiektu request towarzyszącego zdarzeniu DOM geolocation permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki żądającej dostępu do danych geolokalizacji.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa allow nie jest wywoływana.

    Funkcja deny wygląda tak:

    () => {...}

HidPermissionRequest

Chrome w wersji 125 lub nowszej .

Typ obiektu request towarzyszącego zdarzeniu DOM hid permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki żądającej dostępu do interfejsu HID API.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa allow nie jest wywoływana.

    Funkcja deny wygląda tak:

    () => {...}

InjectDetails

Szczegóły skryptu lub kodu CSS do wstrzykiwania. Musisz ustawić kod lub właściwość pliku, ale nie możesz ustawić obu jednocześnie.

Właściwości

  • kod

    ciąg znaków opcjonalny

    Kod JavaScript lub CSS do wstrzykiwania.

    Ostrzeżenie: Zachowaj ostrożność podczas korzystania z parametru code. Jego nieprawidłowe użycie może doprowadzić do ataku na Twoją aplikację za pomocą ataków typu cross-site scripting.

  • plik

    ciąg znaków opcjonalny

    Plik JavaScript lub CSS do wstrzykiwania.

InjectionItems

Chrome w wersji 44 lub nowszej .

Typ elementu wstrzykiwanego: kod lub zbiór plików.

Właściwości

  • kod

    ciąg znaków opcjonalny

    Kod JavaScript lub CSS do wstrzykiwania na pasujących stronach.

  • pliki

    string[] opcjonalnie

    Lista plików JavaScript lub CSS do wstawienia na pasujących stronach. Są one wstrzykiwane w kolejności, w jakiej występują w tej tablicy.

LoadPluginPermissionRequest

Typ obiektu request towarzyszącego zdarzeniu DOM loadplugin permissionrequest.

Właściwości

  • identyfikator

    ciąg znaków

    Ciąg identyfikatora wtyczki.

  • nazwa

    ciąg znaków

    Wyświetlana nazwa wtyczki.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia. Jest to domyślne działanie, jeśli funkcja deny nie jest wywoływana.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia,

    Funkcja deny wygląda tak:

    () => {...}

MediaPermissionRequest

Typ obiektu request towarzyszącego zdarzeniu DOM media permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki żądającej dostępu do multimediów użytkownika.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa allow nie jest wywoływana.

    Funkcja deny wygląda tak:

    () => {...}

NewWindow

Interfejs został dołączony do newwindow zdarzeń DOM.

Właściwości

  • podłączyć

    nieważne

    Dołącz żądaną stronę docelową do istniejącego elementu webview.

    Funkcja attach wygląda tak:

    (webview: object) => {...}

    • komponent WebView

      Obiekt

      Element webview, do którego chcesz dołączyć stronę docelową.

  • odrzuć

    nieważne

    Anuluj prośbę o nowe okno.

    Funkcja discard wygląda tak:

    () => {...}

PointerLockPermissionRequest

Typ obiektu request towarzyszącego zdarzeniu DOM pointerLock permissionrequest.

Właściwości

  • lastUnlockedBySelf

    wartość logiczna

    Określa, czy ramka żądająca była najnowszym klientem, w którym wstrzymano blokadę wskaźnika.

  • URL

    ciąg znaków

    Adres URL ramki żądającej blokady wskaźnika.

  • userGesture

    wartość logiczna

    Wskazuje, czy w wyniku gestu wprowadzania danych zażądano blokady wskaźnika.

  • allow

    nieważne

    Zezwól na prośbę o uprawnienia.

    Funkcja allow wygląda tak:

    () => {...}

  • odmów

    nieważne

    odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa allow nie jest wywoływana.

    Funkcja deny wygląda tak:

    () => {...}

SelectionRect

Opisuje prostokąt we współrzędnych na ekranie.

Semantyka przechowywania przypomina tablicę. oznacza, że współrzędna (left, top) jest uznawana za znajdującą się w prostokątie, ale współrzędna (left + width, top) nie.

Właściwości

  • wysokość

    liczba

    Wysokość prostokąta.

  • w lewo

    liczba

    Odległość od lewej krawędzi ekranu do lewej krawędzi prostokąta.

  • góra

    liczba

    Odległość od górnej krawędzi ekranu do górnej krawędzi prostokąta.

  • szerokość

    liczba

    Szerokość prostokąta.

WebRequestEventInterface

Chrome w wersji 44 lub nowszej .

Interfejs umożliwiający dostęp do zdarzeń webRequest na stronie gościa. Szczegółowe informacje o cyklu życia WebRequest i powiązanych pojęciach znajdziesz w interfejsie API rozszerzeń chrome.webRequest. Uwaga: zdarzenie chrome.webRequest.onActionIgnored nie jest obsługiwane w przypadku komponentów WebView.

Aby pokazać, czym różni się wykorzystanie rozszerzeń od interfejsu webRequest API, zapoznaj się z tym przykładowym kodem, który blokuje żądania gości dotyczące adresów URL pasujących do *://www.evil.com/*:

webview.request.onBeforeRequest.addListener(
  function(details) { return {cancel: true}; },
  {urls: ["*://www.evil.com/*"]},
  ["blocking"]);

Dodatkowo ten interfejs obsługuje deklaratywne reguły WebRequest za pomocą zdarzeń onRequest i onMessage. Szczegółowe informacje o interfejsie API znajdziesz na stronie declarativeWebRequest.

Pamiętaj, że warunki i działania dotyczące deklaratywnych żądań WebView w przeglądarce powinny być tworzone z ich odpowiedników w chrome.webViewRequest.*. Ten przykładowy kod deklaratywnie blokuje wszystkie żądania wysyłane do interfejsu "example.com" w komponencie WebView myWebview:

var rule = {
  conditions: [
    new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
  ],
  actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);

ZoomMode

Chrome w wersji 43 lub nowszej .

Określa sposób powiększania w webview.

Typ wyliczeniowy

"per-origin"
Zmiany powiększenia zostaną zachowane w źródle powiększonej strony, tzn. wszystkie pozostałe komponenty WebView w tej samej partycji, które są przechodzić do tego samego źródła, również zostaną powiększone. Co więcej, zmiany powiększenia w elemencie per-origin są zapisywane z pierwotnym punktem początkowym, co oznacza, że podczas przechodzenia do innych stron w tym samym miejscu wszystkie zostaną powiększone do tego samego współczynnika powiększenia.

"per-view"
Zmiany powiększenia dotyczą tylko tego widoku witryny, a zmiany powiększenia w innych widokach nie mają wpływu na powiększenie tego komponentu. Dodatkowo zmiany powiększenia w per-view są resetowane podczas nawigacji. korzystanie z komponentów WebView będzie zawsze wczytywało strony z określonym współczynnikiem powiększenia dla źródła (w zakresie partycji).

"disable"
Wyłącza całe powiększanie widoku witryny. Zawartość zostanie przywrócona do domyślnego poziomu powiększenia, a wszystkie próby zmiany powiększenia zostaną zignorowane.

Właściwości

contentWindow

Dokumentacja obiektu, która może służyć do publikowania wiadomości na stronie gościa.

contextMenus

Chrome w wersji 44 lub nowszej .

Przypomina interfejs ContextMenus API w Chrome, ale dotyczy webview zamiast przeglądarki. Aby dodać elementy do menu kontekstowego usługi webview, użyj interfejsu API webview.contextMenus. Możesz wybrać typy obiektów, do których mają zastosowanie dodane w menu kontekstowym, np. obrazów, hiperlinków i stron.

request

Interfejs umożliwiający dostęp do zdarzeń webRequest na stronie gościa.

Metody

addContentScripts()

Chrome w wersji 44 lub nowszej .
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)

Dodaje reguły wstawiania skryptów treści do komponentu webview. Gdy webview przejdzie do strony pasującej do co najmniej 1 reguły, powiązane skrypty zostaną wstrzykiwane. Możesz automatycznie dodawać reguły i aktualizować istniejące.

Poniższy przykład dodaje do webview 2 reguły: „myRule” i „inna reguła”.

webview.addContentScripts([
  {
    name: 'myRule',
    matches: ['http://www.foo.com/*'],
    css: { files: ['mystyles.css'] },
    js: { files: ['jquery.js', 'myscript.js'] },
    run_at: 'document_start'
  },
  {
    name: 'anotherRule',
    matches: ['http://www.bar.com/*'],
    js: { code: "document.body.style.backgroundColor = 'red';" },
    run_at: 'document_end'
  }]);
 ...

// Navigates webview.
webview.src = 'http://www.foo.com';

Możesz odroczyć wywołanie addContentScripts do czasu wstrzykiwania skryptów.

Z przykładu poniżej dowiesz się, jak zastąpić istniejącą regułę.

webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.foo.com/*'],
    js: { files: ['scriptA.js'] },
    run_at: 'document_start'}]);

// Do something.
webview.src = 'http://www.foo.com/*';
 ...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.bar.com/*'],
    js: { files: ['scriptB.js'] },
    run_at: 'document_end'}]);

Jeśli interfejs webview został przekierowany do punktu początkowego (np. foo.com) i wywołuje funkcję webview.addContentScripts, aby dodać element „myRule”, musisz poczekać na następną nawigację, aby umożliwić wstrzykiwanie skryptów. Jeśli potrzebujesz natychmiastowego wstrzykiwania, executeScript zrobi to, co trzeba.

Reguły są zachowywane nawet wtedy, gdy proces gościa ulegnie awarii lub zostanie zatrzymany, a nawet jeśli tag webview przestanie być nadrzędny.

Więcej informacji znajdziesz w dokumentacji skryptów treści.

Parametry

back()

chrome.webviewTag.back(
  callback?: function,
)

Przewija wstecz o jeden wpis historii, jeśli to możliwe. Odpowiednik: go(-1).

Parametry

  • wywołanie zwrotne

    funkcja optional

    Chrome w wersji 44 lub nowszej .

    Parametr callback wygląda tak:

    (success: boolean) => void

    • sukces

      wartość logiczna

      Wskazuje, czy nawigacja zakończyła się pomyślnie.

canGoBack()

chrome.webviewTag.canGoBack()

Wskazuje, czy można przechodzić wstecz w historii. Stan tej funkcji jest przechowywany w pamięci podręcznej i aktualizowany przed każdym zdarzeniem loadcommit, więc najlepiej jest ją wywołać w loadcommit.

Zwroty

  • wartość logiczna

canGoForward()

chrome.webviewTag.canGoForward()

Wskazuje, czy można przechodzić do przodu w historii. Stan tej funkcji jest przechowywany w pamięci podręcznej i aktualizowany przed każdym zdarzeniem loadcommit, więc najlepiej jest ją wywołać w loadcommit.

Zwroty

  • wartość logiczna

captureVisibleRegion()

Chrome w wersji 50 lub nowszej .
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)

Przechwytuje widoczny obszar komponentu WebView.

Parametry

  • Opcje

    ImageDetails opcjonalne

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (dataUrl: string) => void

    • dataUrl

      ciąg znaków

      Adres URL danych, który koduje obraz widocznego obszaru na przechwyconej karcie. Może być przypisany do parametru „src” właściwości elementu HTML Image do wyświetlania.

clearData()

chrome.webviewTag.clearData(
  options: ClearDataOptions,
  types: ClearDataTypeSet,
  callback?: function,
)

Usuwa dane przeglądania dla partycji webview.

Parametry

  • Opcje określające, które dane mają zostać wyczyszczone.

  • Typy danych do wyczyszczenia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void

executeScript()

chrome.webviewTag.executeScript(
  details: InjectDetails,
  callback?: function,
)

Wstawia kod JavaScript na stronie gościa.

Ten przykładowy kod korzysta z funkcji wstrzykiwania skryptu, aby ustawić czerwony kolor tła strony gościa:

webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });

Parametry

  • szczegóły

    Szczegóły skryptu do uruchomienia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (result?: any[]) => void

    • wynik

      any[] opcjonalne

      Wynik skryptu w każdej wstrzykniętej klatce.

find()

chrome.webviewTag.find(
  searchText: string,
  options?: FindOptions,
  callback?: function,
)

Wysyła żądanie znajdowania na stronie.

Parametry

  • searchText

    ciąg znaków

    Ciąg do znalezienia na stronie.

  • Opcje

    Opcjonalne FindOptions

    Opcje żądania znalezienia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (results?: FindCallbackResults) => void

    • wyniki

      Zawiera wszystkie wyniki żądania. Pole results można pominąć, jeśli nie jest używane w treści funkcji wywołania zwrotnego. np. gdy wywołanie zwrotne jest używane tylko do wykrywania zakończenia żądania.

forward()

chrome.webviewTag.forward(
  callback?: function,
)

Przechodzi o jeden wpis historii do przodu, jeśli to możliwe. Odpowiednik: go(1).

Parametry

  • wywołanie zwrotne

    funkcja optional

    Chrome w wersji 44 lub nowszej .

    Parametr callback wygląda tak:

    (success: boolean) => void

    • sukces

      wartość logiczna

      Wskazuje, czy nawigacja zakończyła się pomyślnie.

getAudioState()

Chrome w wersji 62 lub nowszej .
chrome.webviewTag.getAudioState(
  callback: function,
)

Zapyta o stan dźwięku.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (audible: boolean) => void

    • audible

      wartość logiczna

getProcessId()

chrome.webviewTag.getProcessId()

Zwraca wewnętrzny identyfikator procesu Chrome dla bieżącego procesu strony internetowej gościa, dzięki czemu osadzone elementy mogą dowiedzieć się, na ilu gości zakończenie tego procesu wpłynie na liczbę gości. Dwóch gości będzie korzystać z tego samego procesu tylko wtedy, gdy należą do tej samej aplikacji i mają ten sam identyfikator partycji miejsca na dane. Wywołanie jest synchroniczne i zwraca wartość bieżącego identyfikatora procesu zapisaną w pamięci podręcznej przez umieszczenie elementu. Identyfikator procesu różni się od identyfikatora procesu w systemie operacyjnym.

Zwroty

  • liczba

getUserAgent()

chrome.webviewTag.getUserAgent()

Zwraca ciąg znaków klienta użytkownika używany przez webview w przypadku żądań stron gościa.

Zwroty

  • ciąg znaków

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)

Pobiera bieżący współczynnik powiększenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (zoomFactor: number) => void

    • zoomFactor

      liczba

      Bieżący współczynnik powiększenia.

getZoomMode()

Chrome w wersji 43 lub nowszej .
chrome.webviewTag.getZoomMode(
  callback: function,
)

Pobiera bieżący tryb powiększenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      Bieżący tryb powiększenia na urządzeniu webview.

go()

chrome.webviewTag.go(
  relativeIndex: number,
  callback?: function,
)

Przechodzi do wpisu historii, korzystając z indeksu historii względem bieżącej nawigacji. Jeśli wybrana nawigacja jest niemożliwa, ta metoda nie działa.

Parametry

  • relativeIndex

    liczba

    Indeks historii względnej, do którego należy przejść w elemencie webview. Na przykład wartość 2 w miarę możliwości powoduje przejście do przodu o 2 wpisy w historii. wartość -3 powoduje przejście do 3 wpisów wstecz.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void

    • sukces

      wartość logiczna

      Wskazuje, czy nawigacja zakończyła się pomyślnie.

insertCSS()

chrome.webviewTag.insertCSS(
  details: InjectDetails,
  callback?: function,
)

Wstawia kod CSS na stronie gościa.

Parametry

  • szczegóły

    Szczegóły kodu CSS do wstawienia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void

isAudioMuted()

Chrome w wersji 62 lub nowszej .
chrome.webviewTag.isAudioMuted(
  callback: function,
)

Zapytanie, czy dźwięk jest wyciszony.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (muted: boolean) => void

    • Wyciszono

      wartość logiczna

isSpatialNavigationEnabled()

Chrome w wersji 71 lub nowszej .
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

Zapytanie, czy nawigacja przestrzenna jest włączona w komponencie WebView.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (enabled: boolean) => void

    • włączone

      wartość logiczna

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

Wskazuje, czy ciąg znaków klienta użytkownika webview został zastąpiony przez webviewTag.setUserAgentOverride.

loadDataWithBaseUrl()

chrome.webviewTag.loadDataWithBaseUrl(
  dataUrl: string,
  baseUrl: string,
  virtualUrl?: string,
)

Wczytuje adres URL danych z określonym podstawowym adresem URL używanym na potrzeby linków względnych. Opcjonalnie możesz podać wirtualny adres URL, który będzie wyświetlany użytkownikowi zamiast adresu URL danych.

Parametry

  • dataUrl

    ciąg znaków

    Adres URL danych do wczytania.

  • baseUrl

    ciąg znaków

    Podstawowy adres URL, który będzie używany w linkach względnych.

  • virtualUrl

    ciąg znaków opcjonalny

    Adres URL, który będzie wyświetlany użytkownikowi (na pasku adresu).

print()

chrome.webviewTag.print()

Drukuje zawartość pola webview. Odpowiada to wywołaniu skryptowej funkcji drukowania z poziomu webview.

reload()

chrome.webviewTag.reload()

Wczytuje ponownie bieżącą stronę najwyższego poziomu.

removeContentScripts()

Chrome w wersji 44 lub nowszej .
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)

Usuwa skrypty treści z elementu webview.

Poniższy przykład pozwala usunąć regułę „myRule” który został dodany wcześniej.

webview.removeContentScripts(['myRule']);

Aby usunąć wszystkie reguły, wywołaj połączenie:

webview.removeContentScripts();

Parametry

  • scriptNameList

    string[] opcjonalnie

    Lista nazw skryptów treści, które zostaną usunięte. Jeśli lista jest pusta, wszystkie skrypty treści dodane do listy webview zostaną usunięte.

setAudioMuted()

Chrome w wersji 62 lub nowszej .
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

Ustawia stan wyciszenia dźwięku w komponencie WebView.

Parametry

  • wycisz

    wartość logiczna

    Wartość wyciszenia dźwięku

setSpatialNavigationEnabled()

Chrome w wersji 71 lub nowszej .
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

Ustawia stan nawigacji przestrzennej komponentu WebView.

Parametry

  • włączone

    wartość logiczna

    Wartość stanu nawigacji przestrzennej.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

Zastąp ciąg znaków klienta użytkownika używany przez webview w żądaniach stron gościa. Zastąpienie spowoduje, że w przypadku żądań stron gościa, do których to zastąpienie zostanie zastosowane, wartości nagłówka podpowiedzi klienta użytkownika i wartości zwracane przez navigator.userAgentData będą puste.

Parametry

  • userAgent

    ciąg znaków

    Ciąg znaków klienta użytkownika, który ma zostać użyty.

setZoom()

chrome.webviewTag.setZoom(
  zoomFactor: number,
  callback?: function,
)

Zmienia współczynnik powiększenia strony. Zakres i trwałość tej zmiany zależy od bieżącego trybu powiększenia komponentu WebView (patrz webviewTag.ZoomMode).

Parametry

  • zoomFactor

    liczba

    Nowy współczynnik powiększenia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void

setZoomMode()

Chrome w wersji 43 lub nowszej .
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

Ustawia tryb powiększenia w urządzeniu webview.

Parametry

  • ZoomMode

    Określa sposób powiększania w elemencie webview.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void

stop()

chrome.webviewTag.stop()

Zatrzymuje wczytywanie bieżącej nawigacji w usłudze webview, jeśli jest w toku.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: "clear"
 | "keep"
 | "activate"
,
)

Kończy bieżącą sesję znajdowania (usuwa wszystkie zaznaczenia) i anuluje wszystkie trwające żądania wyszukiwania.

Parametry

  • działanie

    "clear"
     | "keep"
     | "activate"
     opcjonalnie

    Określa, co zrobić z aktywnym dopasowaniem po zakończeniu sesji znajdowania. clear wyczyści podświetlenie aktywnego dopasowania. keep będzie zaznaczać aktywne dopasowanie. activate będzie wyróżniać aktywne dopasowanie i symulować kliknięcie użytkownika. Działanie domyślne to keep.

terminate()

chrome.webviewTag.terminate()

Wymusza wyłączenie procesu renderowania strony internetowej gościa. Może to mieć wpływ na wiele tagów webview w obecnej aplikacji, jeśli używają one tego samego procesu, ale nie wpłynie to na tagi webview w innych aplikacjach.

Wydarzenia

close

chrome.webviewTag.close.addListener(
  callback: function,
)

Uruchamiane, gdy okno gościa próbuje się zamknąć.

Ten przykładowy kod przekierowuje webview do about:blank, gdy gość próbuje zamknąć się samodzielnie.

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    () => void

consolemessage

chrome.webviewTag.consolemessage.addListener(
  callback: function,
)

Uruchamiane, gdy okno gościa powoduje zarejestrowanie komunikatu w konsoli.

Ten przykładowy kod przekierowuje wszystkie komunikaty logu do konsoli umieszczania bez względu na poziom logowania i inne właściwości.

webview.addEventListener('consolemessage', function(e) {
  console.log('Guest page logged a message: ', e.message);
});

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (level: number, message: string, line: number, sourceId: string) => void

    • poziom

      liczba

    • wiadomość

      ciąg znaków

    • linia

      liczba

    • sourceId

      ciąg znaków

contentload

chrome.webviewTag.contentload.addListener(
  callback: function,
)

Uruchamiane, gdy okno gościa powoduje uruchomienie zdarzenia load, czyli po wczytaniu nowego dokumentu. Nie obejmuje to nawigacji po stronie w bieżącym dokumencie ani wczytywania zasobów asynchronicznych.

Ten przykładowy kod zmienia domyślny rozmiar czcionki elementu body gościa po wczytaniu strony:

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    () => void

dialog

chrome.webviewTag.dialog.addListener(
  callback: function,
)

Uruchamiane, gdy okno gościa próbuje otworzyć okno modalne za pomocą window.alert, window.confirm lub window.prompt.

Obsługa tego zdarzenia spowoduje zablokowanie procesu gościa do czasu powrotu detektora zdarzeń lub dopóki obiekt dialog nie stanie się nieosiągalny (jeśli został wywołany preventDefault()).

Domyślnym zachowaniem jest anulowanie okna.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (messageType: "alert" 
     | "confirm"
     | "prompt"
    , messageText: string, dialog: DialogController) => void

    • messageType

      "alert"
       | "confirm"
       | "prompt"

    • messageText

      ciąg znaków

    • okno|okno dialogowe

exit

chrome.webviewTag.exit.addListener(
  callback: function,
)

Uruchamiane po zakończeniu procesu renderowania treści internetowej gościa.

Ten przykładowy kod wyświetla wiadomość pożegnalną za każdym razem, gdy strona gościa ulegnie awarii:

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,Goodbye, world!';
  }
});

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (processID: number, reason: "normal" 
     | "abnormal"
     | "crash"
     | "kill"
    ) => void

    • processID

      liczba

    • powód

      "normal"
       | "abnormal"
       | "crash"
       | "kill"

findupdate

chrome.webviewTag.findupdate.addListener(
  callback: function,
)

Uruchamiane, gdy dostępne są nowe wyniki dla aktywnego żądania wyszukiwania. Może się to zdarzyć kilka razy w przypadku pojedynczego żądania wyszukiwania, gdy zostaną znalezione pasujące wyniki.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

    • searchText

      ciąg znaków

    • numberOfMatches

      liczba

    • activeMatchOrdinal

      liczba

    • selectionRect
    • anulowano

      wartość logiczna

    • finalUpdate

      ciąg znaków

loadabort

chrome.webviewTag.loadabort.addListener(
  callback: function,
)

Uruchamiane, gdy ładowanie najwyższego poziomu zostało przerwane bez zatwierdzenia. Komunikat o błędzie zostanie wyświetlony w konsoli, chyba że to zdarzenie jest ustawione jako domyślne.

Uwaga: po przerwaniu wczytywania zasobów zdarzenie loadabort zostanie ostatecznie zakończone zdarzeniem loadstop, nawet jeśli wszystkie zatwierdzone operacje wczytywania od ostatniego zdarzenia loadstop (jeśli jakiekolwiek wystąpiły) zostały przerwane.

Uwaga: w przypadku przerwania wczytywania adresu URL z informacjami lub adresu URL JavaScriptu polecenie loadabort zostanie uruchomione, a webview nastąpi przekierowanie do ciągu „about:blank”.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (url: string, isTopLevel: boolean, code: number, reason: "ERR_ABORTED" 
     | "ERR_INVALID_URL"
     | "ERR_DISALLOWED_URL_SCHEME"
     | "ERR_BLOCKED_BY_CLIENT"
     | "ERR_ADDRESS_UNREACHABLE"
     | "ERR_EMPTY_RESPONSE"
     | "ERR_FILE_NOT_FOUND"
     | "ERR_UNKNOWN_URL_SCHEME"
    ) => void

    • URL

      ciąg znaków

    • isTopLevel

      wartość logiczna

    • kod

      liczba

    • powód

      "ERR_ABORTED"
       | &quot;ERR_INVALID_URL&quot;
       | &quot;ERR_DISALLOWED_URL_SCHEME&quot;
       | &quot;ERR_BLOCKED_BY_CLIENT&quot;
       | "ERR_ADDRESS_UNREACHABLE"
       | &quot;ERR_EMPTY_RESPONSE&quot;
       | &quot;ERR_FILE_NOT_FOUND&quot;
       | &quot;ERR_UNKNOWN_URL_SCHEME&quot;

loadcommit

chrome.webviewTag.loadcommit.addListener(
  callback: function,
)

Uruchamiane po zatwierdzeniu obciążenia. Obejmuje to nawigację w obrębie bieżącego dokumentu oraz wczytywania ramki podrzędnej na poziomie dokumentu, ale nie uwzględnia asynchronicznego wczytywania zasobów.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (url: string, isTopLevel: boolean) => void

    • URL

      ciąg znaków

    • isTopLevel

      wartość logiczna

loadredirect

chrome.webviewTag.loadredirect.addListener(
  callback: function,
)

Uruchamiane, gdy żądanie wczytywania najwyższego poziomu przekierowuje pod inny adres URL.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

    • oldUrl

      ciąg znaków

    • newUrl

      ciąg znaków

    • isTopLevel

      wartość logiczna

loadstart

chrome.webviewTag.loadstart.addListener(
  callback: function,
)

Uruchamiane po rozpoczęciu wczytywania.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (url: string, isTopLevel: boolean) => void

    • URL

      ciąg znaków

    • isTopLevel

      wartość logiczna

loadstop

chrome.webviewTag.loadstop.addListener(
  callback: function,
)

Uruchamiane po zakończeniu wczytywania wszystkich klatek na poziomie klatki na stronie gościa (wraz ze wszystkimi jej ramkami podrzędnymi). Obejmuje to nawigację w obrębie bieżącego dokumentu oraz wczytywania ramki podrzędnej na poziomie dokumentu, ale nie uwzględnia asynchronicznego wczytywania zasobów. To zdarzenie jest wywoływane za każdym razem, gdy liczba wczytań na poziomie dokumentu zmieni się z 1 (lub więcej) na 0. Jeśli na przykład strona, której wczytywanie zostało już zakończone (np. loadstop już raz) tworzy nowy element iframe, który wczytuje stronę. Potem po zakończeniu wczytywania strony iframe uruchomi się drugi element loadstop. Ten wzorzec często występuje na stronach, na których wczytują się reklamy.

Uwaga: po przerwaniu zaplanowanego wczytywania zdarzenie loadstop będzie później następować po zdarzeniu loadabort nawet wtedy, gdy wszystkie zatwierdzone operacje wczytywania od ostatniego zdarzenia loadstop (jeśli jakiekolwiek wystąpiły) zostały przerwane.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    () => void

newwindow

chrome.webviewTag.newwindow.addListener(
  callback: function,
)

Uruchamiane, gdy strona gościa próbuje otworzyć nowe okno przeglądarki.

Ten przykładowy kod utworzy nowy element webview w umieszczonym elemencie i porusza się po nim w przypadku każdego żądanego nowego okna:

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: "ignore" 
     | "save_to_disk"
     | "current_tab"
     | "new_background_tab"
     | "new_foreground_tab"
     | "new_window"
     | "new_popup"
    ) => void

    • okno
    • targetUrl

      ciąg znaków

    • initialWidth

      liczba

    • initialHeight

      liczba

    • nazwa

      ciąg znaków

    • windowOpenDisposition

      "ignore"
       | "save_to_disk"
       | "current_tab"
       | &quot;new_background_tab&quot;
       | "new_foreground_tab"
       | "new_window"
       | "new_popup"

permissionrequest

chrome.webviewTag.permissionrequest.addListener(
  callback: function,
)

Uruchamiane, gdy strona gościa musi poprosić o specjalne uprawnienia od osadzonego komponentu.

Ten przykładowy kod przyzna stronie gościa dostęp do interfejsu API webkitGetUserMedia. Pamiętaj, że aplikacja, która korzysta z tego przykładowego kodu, musi sama określać uprawnienia audioCapture lub videoCapture w pliku manifestu:

webview.addEventListener('permissionrequest', function(e) {
  if (e.permission === 'media') {
    e.request.allow();
  }
});

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (permission: "media" 
     | "geolocation"
     | "pointerLock"
     | "download"
     | "loadplugin"
     | "filesystem"
     | "fullscreen"
     | "hid"
    , request: object) => void

    • uprawnienie

      "media"
       | "geolocation"
       | "pointerLock"
       | "download"
       | "loadplugin"
       | "filesystem"
       | "fullscreen"
       | "hid"

    • żądanie

      Obiekt

responsive

chrome.webviewTag.responsive.addListener(
  callback: function,
)

Uruchamiane, gdy proces renderowania treści internetowych dla gości ponownie reaguje po tym, jak przestał.

Ten przykładowy kod powoduje stopniowe zanikanie i wygładzanie elementu webview w miarę, jak element ten zaczyna odpowiadać lub nie reaguje:

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (processID: number) => void

    • processID

      liczba

sizechanged

chrome.webviewTag.sizechanged.addListener(
  callback: function,
)

Uruchamiane po zmianie rozmiaru umieszczonej treści internetowej w interfejsie autosize. Uruchamiany tylko wtedy, gdy zasada autosize jest włączona.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

    • oldWidth

      liczba

    • oldHeight

      liczba

    • newWidth

      liczba

    • newHeight

      liczba

unresponsive

chrome.webviewTag.unresponsive.addListener(
  callback: function,
)

Uruchamiane, gdy proces renderowania treści internetowej gościa przestał reagować. To zdarzenie zostanie wygenerowane jeden raz z pasującym zdarzeniem elastycznym, jeśli gość ponownie zacznie odpowiadać.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (processID: number) => void

    • processID

      liczba

zoomchange

chrome.webviewTag.zoomchange.addListener(
  callback: function,
)

Uruchamiane po zmianie powiększenia strony.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (oldZoomFactor: number, newZoomFactor: number) => void

    • oldZoomFactor

      liczba

    • newZoomFactor

      liczba