chrome.webviewTag

Opis

Użyj tagu webview, aby aktywnie wczytywać na żywo treści z internetu przez sieć i osadzać je w aplikacji Chrome. Twoja aplikacja może kontrolować wygląd tagu webview i interagować z treściami internetowymi, inicjować nawigację na osadzoną stronę internetową, reagować na zdarzenia błędu, które się na niej pojawiają, oraz wykonywać inne czynności (patrz Użycie).

Uprawnienia

webview

Typy

ClearDataOptions

Opcje określające, jakie dane mają być wyczyszczone przez clearData.

Właściwości

  • od

    number opcjonalny

    Wyczyść dane zgromadzone w tym dniu lub później, wyrażone w milisekundach od początku ery (dostępne za pomocą metody getTime obiektu JavaScript Date). Jeśli nie ma tej wartości, domyślnie ustawiana jest wartość 0 (co spowoduje 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

  • appcache

    wartość logiczna opcjonalna

    pamięci podręczne aplikacji witryn.

  • Pamięć podręczna

    wartość logiczna opcjonalna

    Chrome 44 lub nowszy

    Od wersji Chrome 43. Pamięć podręczna przeglądarki. Uwaga: usuwanie danych powoduje wyczyszczenie całej pamięci podręcznej, a nie tylko określonego zakresu.

  • ciastka

    wartość logiczna opcjonalna

    pliki cookie partycji;

  • fileSystems

    wartość logiczna opcjonalna

    systemy plików witryn.

  • indexedDB

    wartość logiczna opcjonalna

    dane IndexedDB witryn.

  • localStorage

    wartość logiczna opcjonalna

    dane z pamięci lokalnej witryn;

  • persistentCookies

    wartość logiczna opcjonalna

    Chrome 58 lub nowszy

    trwałe pliki cookie w danym wydzieleniu.

  • sessionCookies

    wartość logiczna opcjonalna

    Chrome 58 lub nowszy

    Pliki cookie sesji w partycji.

  • webSQL

    wartość logiczna opcjonalna

    dane WebSQL witryn

ContentScriptDetails

Chrome 44 lub nowszy

Szczegóły skryptu treści do wstrzyknięcia. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją skryptów treści.

Właściwości

  • all_frames

    wartość logiczna opcjonalna

    Jeśli all_frames to true, oznacza to, że kod JavaScript lub CSS powinien zostać wstrzyknięty do wszystkich ramek bieżącej strony. Domyślnie all_frames to false, a kod JavaScript lub CSS jest wstrzykiwany tylko do górnej ramki.

  • css

    InjectionItems opcjonalne

    Kod CSS lub lista plików CSS do wstrzyknięcia na pasujące strony. Są one wstawiane w kolejności, w jakiej się pojawiają, zanim DOM zostanie utworzony lub wyświetlony na stronie.

  • exclude_globs

    string[] opcjonalnie

    Stosuje się go po dopasowaniu, aby wykluczyć adresy URL pasujące do tego wzorca. Słowo kluczowe służące do naśladowania słowa kluczowego Greasemonkey @exclude.

  • exclude_matches

    string[] opcjonalnie

    Wyklucza strony, na które skrypt treści miałby zostać wstrzyknięty.

  • include_globs

    string[] opcjonalnie

    Stosuje się go po dopasowaniu, aby uwzględnić tylko te adresy URL, które pasują do tego wzorca. Słowo kluczowe @include służy do emulowania słowa kluczowego Greasemonkey.

  • js

    InjectionItems opcjonalne

    Kod JavaScript lub lista plików JavaScript, które mają zostać wstrzyknięte na pasujące strony. Są one wstawiane w kolejności, w jakiej się pojawiają.

  • match_about_blank

    wartość logiczna opcjonalna

    Określa, czy skrypt treści ma być wstawiany w adresie about:blank i about:srcdoc. Skrypty treści będą wstrzykiwane na stronach tylko wtedy, gdy ich dziedziczony adres URL będzie pasować do jednego z deklarowanych wzorów w polu dopasowań. Adres URL dziedziczenia to adres URL dokumentu, który utworzył ramkę lub okno. Skrypty treści nie mogą być wstawiane w ramach piaskownicy.

  • pasuje do

    string[]

    Określa, na których stronach ma być wstrzykiwany skrypt treści.

  • nazwa

    ciąg znaków

    Nazwa skryptu treści do wstrzyknięcia.

  • run_at

    RunAt opcjonalny

    Najwcześniejszy termin, w którym kod JavaScript lub CSS zostanie wstrzyknięty do karty. Wartość domyślna to „document_idle”.

ContentWindow

Przesyłanie wiadomości do okna gościa.

Właściwości

  • postMessage

    nieważne

    Publikuje wiadomość w osadzonym materiale internetowym, o ile osadzony materiał wyświetla stronę z docelonego źródła. Ta metoda jest dostępna po załadowaniu strony. Nasłuchuj zdarzenie contentload, a potem wywołaj metodę.

    Gość będzie mógł wysyłać odpowiedzi do osoby, która go dodała, publikując wiadomość do event.source w odpowiedzi na otrzymane zdarzenie wiadomości.

    Ten interfejs jest identyczny z interfejsem HTML5 postMessage API do komunikacji między stronami internetowymi. Użytkownik może słuchać odpowiedzi, dodając do swojego ramki detektor zdarzenia message.

    Funkcja postMessage ma postać:

    (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 44 lub nowszy

Właściwości

  • zaznaczono

    wartość logiczna opcjonalna

    Początkowy stan pola wyboru lub opcji: PRAWDA oznacza wybranie, FAŁSZ – odznaczenie. W danej grupie elementów opcjonalnych może być zaznaczony tylko 1 element.

  • kontekstów

    [ContextType, ...ContextType[]] opcjonalnie

    Lista kontekstów, w których element menu będzie się pojawiać. Jeśli nie zostanie podany, przyjmuje się domyślnie ['page'].

  • documentUrlPatterns

    string[] opcjonalnie

    Umożliwia ograniczenie działania elementu tylko do dokumentów, których adres URL pasuje do jednego z podanych wzorców. (dotyczy to też ramek). Szczegółowe informacje o formacie wzorca znajdziesz w artykule Wzorce dopasowania.

  • włączone

    wartość logiczna opcjonalna

    Wskazuje, czy 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. Wymagany w przypadku stron z informacjami o wydarzeniach. Nie może być taki sam jak inny identyfikator tego rozszerzenia.

  • parentId

    string | number opcjonalnie

    Identyfikator nadrzędnego elementu menu; dzięki temu element staje się elementem podrzędnym wcześniej dodanego elementu.

  • targetUrlPatterns

    string[] opcjonalnie

    Podobnie jak w przypadku atrybutu documentUrlPatterns, ale umożliwia filtrowanie według atrybutu src w tagach img/audio/video i atrybutu href w tagach kotwicy.

  • tytuł

    ciąg znaków opcjonalny

    Tekst wyświetlany w elemencie. Jest wymagany, chyba że type to „separator”. Jeśli kontekst to „wybór”, możesz użyć w ciągu znaków %s, aby wyświetlić wybrany tekst. Jeśli na przykład wartość tego parametru to „Tłumacz '%s' na pig-latin”, a użytkownik wybierze słowo „fajny”, element menu kontekstowego dla tej selekcji to „Tłumacz 'fajny' na pig-latin”.

  • typ

    ItemType opcjonalny

    Typ pozycji menu. Jeśli nie zostanie podany, domyślnie przyjmuje się wartość „normal”.

  • onclick

    void opcjonalny

    Funkcja, która zostanie wywołana po kliknięciu elementu menu.

    Funkcja onclick ma postać:

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

    • informacje

      OnClickData

      Informacje o klikniętym elemencie i kontekście, w którym nastąpiło kliknięcie.

ContextMenus

Chrome 44 lub nowszy

Właściwości

  • onShow

    Zdarzenie<functionvoidvoid>

    Wywoływany przed wyświetleniem menu kontekstowego w tym webview. Może służyć do wyłączenia tego menu kontekstowego przez wywołanie funkcji event.preventDefault().

    Funkcja onShow.addListener ma postać:

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

    • wywołanie zwrotne

      funkcja

      Parametr callback ma postać:

      (event: object) => void

      • event

        Obiekt

        • preventDefault

          nieważne

          Wywołaj tę funkcję, aby zapobiec wyświetlaniu menu kontekstowego.

          Funkcja preventDefault ma postać:

          () => {...}

  • utwórz

    nieważne

    Tworzy nowy element menu kontekstowego. Pamiętaj, że jeśli podczas tworzenia wystąpi błąd, możesz się o tym nie dowiedzieć, dopóki nie zostanie wywołana funkcja wywołania zwrotnego podczas tworzenia (szczegóły znajdziesz w runtime.lastError).

    Funkcja create ma postać:

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

    • createProperties

      Obiekt

      właściwości użyte do utworzenia elementu.

    • wywołanie zwrotne

      function opcjonalny

      Parametr callback ma postać:

      () => void

    • returns

      ciąg | liczba

      Identyfikator nowo utworzonego elementu.

  • usuń

    nieważne

    Usuwa element menu kontekstowego.

    Funkcja remove ma postać:

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

    • menuItemId

      ciąg | liczba

      Identyfikator pozycji menu kontekstowego do usunięcia.

    • wywołanie zwrotne

      function opcjonalny

      Parametr callback ma postać:

      () => void

  • removeAll

    nieważne

    Usuwa wszystkie elementy menu kontekstowego dodane do tego webview.

    Funkcja removeAll ma postać:

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

    • wywołanie zwrotne

      function opcjonalny

      Parametr callback ma postać:

      () => void

  • update

    nieważne

    Aktualizuje wcześniej utworzony element menu kontekstowego.

    Funkcja update ma postać:

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

    • id

      ciąg | liczba

      Identyfikator elementu, który chcesz zaktualizować.

    • updateProperties

      Obiekt

      Właściwości do zaktualizowania. Przyjmuje te same wartości co funkcja create.

    • wywołanie zwrotne

      function opcjonalny

      Parametr callback ma postać:

      () => void

ContextMenuUpdateProperties

Chrome 44 lub nowszy

Właściwości

  • zaznaczono

    wartość logiczna opcjonalna

    Stan pola wyboru lub opcji: „true” (prawda) – zaznaczone, „false” (fałsz) – niezaznaczone. W danej grupie elementów opcjonalnych może być zaznaczony tylko 1 element.

  • kontekstów

    [ContextType, ...ContextType[]] opcjonalnie

    Lista kontekstów, w których element menu będzie się pojawiać.

  • documentUrlPatterns

    string[] opcjonalnie

    Umożliwia ograniczenie działania elementu tylko do dokumentów, których adres URL pasuje do jednego z podanych wzorców. (dotyczy to też ramek). Szczegółowe informacje o formacie wzorca znajdziesz w artykule Wzorce dopasowania.

  • włączone

    wartość logiczna opcjonalna

    Wskazuje, czy pozycja menu kontekstowego jest włączona czy wyłączona.

  • parentId

    string | number opcjonalnie

    Identyfikator nadrzędnego elementu menu; dzięki temu element staje się elementem podrzędnym wcześniej dodanego elementu. Uwaga: nie możesz zmienić elementu tak, aby był on podrzędnym jednego ze swoich potomków.

  • targetUrlPatterns

    string[] opcjonalnie

    Podobnie jak w przypadku atrybutu documentUrlPatterns, ale umożliwia filtrowanie według atrybutu src w tagach img/audio/video i atrybutu href w tagach kotwicy.

  • tytuł

    ciąg znaków opcjonalny

    Tekst do wyświetlenia w elemencie

  • typ

    ItemType opcjonalny

    Typ pozycji menu.

  • onclick

    void opcjonalny

    Funkcja, która zostanie wywołana po kliknięciu elementu menu.

    Funkcja onclick ma postać:

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

    • informacje

      OnClickData

      Informacje o klikniętym elemencie i kontekście, w którym nastąpiło kliknięcie.

ContextType

Chrome 44 lub nowszy

Różne konteksty, w których może się wyświetlać menu. Podanie wartości „all” (wszystko) jest równoznaczne z kombinacją wszystkich innych kontekstów.

Typ wyliczeniowy

„all”

„page”

"frame"

„selection”

"link"

„edytowane”

„image”

"video"

„audio”

DialogController

Interfejs dołączony do zdarzeń DOM dialog.

Właściwości

  • anuluj

    nieważne

    Odrzuć okno. To działanie jest równoważne kliknięciu Anuluj w oknie confirm lub prompt.

    Funkcja cancel ma postać:

    () => {...}

  • OK

    nieważne

    Zaakceptuj okno. To działanie jest równoważne kliknięciu OK w oknie alert, confirm lub prompt.

    Funkcja ok ma postać:

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

    • odpowiedź

      ciąg znaków opcjonalny

      Ciąg tekstowy odpowiedzi, który należy przekazać gościowi po zaakceptowaniu okna dialogowego prompt.

DownloadPermissionRequest

Typ obiektu request, który towarzyszy 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

    Adres URL żądanego pliku do pobrania.

  • allow

    nieważne

    Zezwól na dostęp.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień; Jest to zachowanie domyślne, jeśli nie wywołano funkcji allow.

    Funkcja deny ma postać:

    () => {...}

FileSystemPermissionRequest

Typ obiektu request, który towarzyszy zdarzeniu DOM filesystem permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki proszącej o dostęp do lokalnego systemu plików.

  • allow

    nieważne

    Zezwól na dostęp.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień;

    Funkcja deny ma postać:

    () => {...}

FindCallbackResults

Zawiera wszystkie wyniki żądania znajdowania.

Właściwości

  • activeMatchOrdinal

    liczba

    Numer porządkowy bieżącego dopasowania.

  • anulowano

    wartość logiczna

    Wskazuje, czy ta prośba o wyszukiwanie została anulowana.

  • numberOfMatches

    liczba

    Liczba wystąpień searchText na stronie.

  • selectionRect

    SelectionRect

    Określa prostokąt wokół aktywnego dopasowania w współrzędnych ekranu.

FindOptions

Opcje prośby o wyszukiwanie.

Właściwości

  • wstecz

    wartość logiczna opcjonalna

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

  • matchCase

    wartość logiczna opcjonalna

    Flaga dopasowania z uwzględnieniem wielkości liter. Wartością domyślną jest false.

FullscreenPermissionRequest

Chrome 43 lub nowszy

Typ obiektu request, który towarzyszy zdarzeniu DOM fullscreen permissionrequest.

Właściwości

  • pochodzenie

    ciąg znaków

    Źródło klatki w ramach webview, które zapoczątkowało żądanie pełnego ekranu.

  • allow

    nieważne

    Zezwól na dostęp.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień;

    Funkcja deny ma postać:

    () => {...}

GeolocationPermissionRequest

Typ obiektu request, który towarzyszy zdarzeniu DOM geolocation permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki proszącej o dostęp do danych geolokalizacyjnych.

  • allow

    nieważne

    Zezwól na dostęp.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień; Jest to zachowanie domyślne, jeśli nie wywołano funkcji allow.

    Funkcja deny ma postać:

    () => {...}

HidPermissionRequest

Chrome w wersji 125 lub nowszej

Typ obiektu request, który towarzyszy zdarzeniu DOM hid permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki proszącej o dostęp do interfejsu HID API.

  • allow

    nieważne

    Zezwól na dostęp.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień; Jest to zachowanie domyślne, jeśli nie wywołano funkcji allow.

    Funkcja deny ma postać:

    () => {...}

InjectDetails

Szczegóły skryptu lub kodu CSS, który chcesz wstrzyknąć. Musisz ustawić kod lub plik, ale nie możesz ustawić obu naraz.

Właściwości

  • kod

    ciąg znaków opcjonalny

    kod JavaScript lub CSS, który chcesz wstrzyknąć.

    Ostrzeżenie: używaj parametru code z uwagą. Nieprawidłowe użycie tej funkcji może narazić aplikację na ataki typu cross-site scripting.

  • plik

    ciąg znaków opcjonalny

    Plik JavaScript lub CSS, który chcesz wstrzyknąć.

InjectionItems

Chrome 44 lub nowszy

Typ elementu wstrzyknięcia: kod lub zestaw plików.

Właściwości

  • kod

    ciąg znaków opcjonalny

    kod JavaScript lub arkusz CSS, który ma być wstrzykiwany na pasujące strony.

  • pliki

    string[] opcjonalnie

    Lista plików JavaScript lub CSS, które mają zostać wstrzyknięte na pasujące strony. Są one wstawiane w kolejności, w jakiej występują w tej tablicy.

LoadPluginPermissionRequest

Typ obiektu request, który towarzyszy zdarzeniu DOM loadplugin permissionrequest.

Właściwości

  • identyfikator

    ciąg znaków

    Identyfikator w postaci ciągu znaków.

  • nazwa

    ciąg znaków

    Wyświetlana nazwa wtyczki.

  • allow

    nieważne

    Zezwól na dostęp. Jest to zachowanie domyślne, jeśli nie wywołano funkcji deny.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień;

    Funkcja deny ma postać:

    () => {...}

MediaPermissionRequest

Typ obiektu request, który towarzyszy zdarzeniu DOM media permissionrequest.

Właściwości

  • URL

    ciąg znaków

    Adres URL ramki proszącej o dostęp do multimediów użytkownika.

  • allow

    nieważne

    Zezwól na dostęp.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień; Jest to zachowanie domyślne, jeśli nie wywołano funkcji allow.

    Funkcja deny ma postać:

    () => {...}

NewWindow

Interfejs dołączony do zdarzeń DOM newwindow.

Właściwości

  • podłączyć

    nieważne

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

    Funkcja attach ma postać:

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

    • WebView

      Obiekt

      Element webview, do którego należy dołączyć stronę docelową.

  • odrzuć

    nieważne

    Anuluj prośbę o nowe okno.

    Funkcja discard ma postać:

    () => {...}

PointerLockPermissionRequest

Typ obiektu request, który towarzyszy zdarzeniu DOM pointerLock permissionrequest.

Właściwości

  • lastUnlockedBySelf

    wartość logiczna

    Określa, czy ramka wysyłająca żądanie była ostatnim klientem, który zablokował wskaźnik.

  • URL

    ciąg znaków

    Adres URL ramki, która prosi o blokadę wskaźnika.

  • userGesture

    wartość logiczna

    Określa, czy zablokowanie wskaźnika zostało zażądane w wyniku gestu użytkownika.

  • allow

    nieważne

    Zezwól na dostęp.

    Funkcja allow ma postać:

    () => {...}

  • odmowa

    nieważne

    odmówić udzielenia uprawnień; Jest to zachowanie domyślne, jeśli nie wywołano funkcji allow.

    Funkcja deny ma postać:

    () => {...}

SelectionRect

Opisuje prostokąt w współrzędnych ekranu.

Semantyka zawierania jest podobna do semantyki tablic, co oznacza, że współrzędna (left, top) jest uważana za zawartą w prostokącie, 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 44 lub nowszy

Interfejs, który zapewnia dostęp do zdarzeń webRequest na stronie gościa. Szczegółowe informacje o cyklu życia webRequest i powiązanych z nim pojęciach znajdziesz w interfejsie API rozszerzeń chrome.webRequest. Uwaga: zdarzenie chrome.webRequest.onActionIgnored nie jest obsługiwane w przypadku widoków internetowych.

Aby zilustrować, jak różni się sposób korzystania z interfejsu webRequest API w rozszerzeniach, rozważ ten przykładowy kod, który blokuje wszystkie żądania gościa 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. Więcej informacji o interfejsie API znajdziesz w artykule declarativeWebRequest.

Pamiętaj, że warunki i działania dla deklaratywnych webRequests w webview powinny być tworzone na podstawie odpowiedników chrome.webViewRequest.*. Poniższy przykładowy kod deklaratywnie blokuje wszystkie żądania do "example.com" w widoku internetowym myWebview:

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

ZoomMode

Chrome 43 lub nowszy

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

Typ wyliczeniowy

„per-origin”
Zmiany powiększenia będą trwałe w przypadku strony źródłowej powiększonej strony, tzn. wszystkie inne widoki stron w tej samej partycji, które są nawigowane do tej samej strony źródłowej, również będą powiększone. Ponadto zmiany per-origin są zapisywane w źródle, co oznacza, że podczas przechodzenia na inne strony w tym samym źródle wszystkie będą miały ten sam stopień powiększenia.

„Per-view”
Zmiany powiększenia będą miały zastosowanie tylko w tym widoku witryny, a zmiany powiększenia w innych widokach witryny nie będą miały wpływu na powiększenie tego widoku. Ponadto zmiany powiększenia per-view są resetowane podczas nawigacji. Podczas nawigacji w widoku webview zawsze będą wczytywane strony z powiększeniem dla danego źródła (w ramach partycji).

„disabled” (wyłączone)
Wyłącza wszystkie opcje powiększania w widoku przeglądarki. Treści zostaną przywrócone do domyślnego poziomu powiększenia, a wszystkie próby zmiany powiększenia zostaną zignorowane.

Właściwości

contentWindow

Odwołuje się do obiektu, który może służyć do publikowania wiadomości na stronie gościa.

Typ

ContentWindow

contextMenus

Chrome 44 lub nowszy

Interfejs ContextMenus API jest podobny do interfejsu ContextMenus API przeglądarki Chrome, ale dotyczy webview zamiast przeglądarki. Aby dodać elementy do menu kontekstowego webview, użyj interfejsu API webview.contextMenus. Możesz wybrać, do jakich obiektów mają się odnosić elementy menu kontekstowego, np. obrazy, hiperlinki i strony.

Typ

ContextMenus

request

Interfejs, który zapewnia dostęp do zdarzeń webRequest na stronie gościa.

Typ

WebRequestEventInterface

Metody

addContentScripts()

Chrome 44 lub nowszy 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)

Dodaje reguły wstrzykiwania skryptów do webview. Gdy webview przejdzie na stronę zgodną z co najmniej 1 regułą, zostaną wstrzyknięte powiązane skrypty. Możesz dodawać reguły za pomocą kodu lub aktualizować istniejące reguły.

W tym przykładzie do webview dodawane są 2 reguły: „myRule” i „anotherRule”.

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, dopóki nie będzie trzeba wstrzyknąć skrypty.

Przykład poniżej pokazuje, jak zastąpić istniejące reguły.

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 webview została przekierowana do źródła (np. foo.com) i wywołuje webview.addContentScripts, aby dodać „myRule”, musisz zaczekać na następne przekierowanie, aby skrypty zostały wstrzyknięte. Jeśli chcesz natychmiastowego wstrzyknięcia, executeScript będzie odpowiedni.

Reguły są zachowywane nawet wtedy, gdy proces gościa ulegnie awarii lub zostanie zabity, a nawet jeśli webview zostanie przypisany do innego rodzica.

Aby dowiedzieć się więcej, zapoznaj się z dokumentacją skryptów treści.

Parametry

back()

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

Wstecz przenosi o jeden wpis w historii (jeśli to możliwe). Odpowiednik: go(-1).

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Chrome 44 lub nowszy

    Parametr callback ma postać:

    (success: boolean) => void

    • sukces

      wartość logiczna

      Wskazuje, czy nawigacja się powiodła.

canGoBack()

chrome.webviewTag.canGoBack()

Wskazuje, czy można cofnąć się w historii. Stan tej funkcji jest przechowywany w pamięci podręcznej i aktualizowany przed każdym loadcommit, dlatego najlepiej wywoływać ją w funkcji 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 loadcommit, dlatego najlepiej wywoływać ją w funkcji loadcommit.

Zwroty

  • wartość logiczna

captureVisibleRegion()

Chrome 50+ 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)

Wykonuje zrzut widocznego obszaru widoku internetowego.

Parametry

  • Opcje

    ImageDetails opcjonalnie

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (dataUrl: string) => void

    • dataUrl

      ciąg znaków

      Adres URL danych, który koduje obraz widocznego obszaru przechwyconej karty. Może być przypisany do właściwości „src” elementu obrazu HTML w celu wyświetlenia.

clearData()

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

Wyczyszczenie danych przeglądania w partycji webview.

Parametry

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

  • Typy danych, które mają zostać wyczyszczone.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

executeScript()

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

Wstrzykuje kod JavaScript na stronie gościa.

Poniższy przykładowy kod używa wstrzyknięcia skryptu, aby ustawić kolor tła strony gościa na czerwony:

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

Parametry

  • szczegóły

    InjectDetails

    Szczegóły skryptu do wykonania.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result?: any[]) => void

    • wynik

      any[] opcjonalny

      Wynik skryptu w każdej wstrzykniętej klatce.

find()

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

Inicjowanie żądania wyszukiwania na stronie.

Parametry

  • searchText

    ciąg znaków

    Ciąg do znalezienia na stronie.

  • Opcje

    FindOptions opcjonalnie

    Opcje prośby o wyszukiwanie.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (results?: FindCallbackResults) => void

    • wyniki

      FindCallbackResults opcjonalnie

      Zawiera wszystkie wyniki żądania znajdowania. results można pominąć, jeśli nie jest używany w ciele funkcji wywołania zwrotnego, na przykład wtedy, gdy służy tylko do określenia, kiedy zakończyło się żądanie znajdowania.

forward()

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

Przechodzi do następnego wpisu w historii, jeśli to możliwe. Odpowiednik: go(1).

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Chrome 44 lub nowszy

    Parametr callback ma postać:

    (success: boolean) => void

    • sukces

      wartość logiczna

      Wskazuje, czy nawigacja się udała.

getAudioState()

Chrome 62 lub nowszy 
chrome.webviewTag.getAudioState(
  callback: function,
)

Zapytania o stan dźwięku.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (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 osoby umieszczające mogą dowiedzieć się, ilu gości dotyczyłoby zakończenie procesu. 2 użytkowników gościnnych będą dzielić proces tylko wtedy, gdy należą do tej samej aplikacji i mają ten sam identyfikator partycji pamięci. Wywołanie jest synchroniczne i zwraca zapisany w pamięci podręcznej identyfikator procesu w formacie z wklejeniem. Identyfikator procesu nie jest taki sam jak identyfikator procesu systemu operacyjnego.

Zwroty

  • liczba

getUserAgent()

chrome.webviewTag.getUserAgent()

Zwraca ciąg znaków klienta użytkownika używany przez webview do żą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 ma postać:

    (zoomFactor: number) => void

    • zoomFactor

      liczba

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

getZoomMode()

Chrome 43 lub nowszy 
chrome.webviewTag.getZoomMode(
  callback: function,
)

Pobiera bieżący tryb powiększenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      ZoomMode

      Obecny tryb powiększenia webview.

go()

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

Przechodzi do wpisu w historii, korzystając z indeksu historii względem bieżącej nawigacji. Jeśli żądana nawigacja jest niemożliwa, ta metoda nie ma zastosowania.

Parametry

  • relativeIndex

    liczba

    Współrzędna indeksu historii, do której ma przejść webview. Jeśli na przykład wpiszesz wartość 2, przejdziesz do 2 najnowszych wpisów w historii (jeśli to możliwe). Jeśli wpiszesz wartość -3, przejdziesz do 3 najstarszych wpisów.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (success: boolean) => void

    • sukces

      wartość logiczna

      Wskazuje, czy nawigacja się powiodła.

insertCSS()

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

Wstawia pliki CSS na stronie gościa.

Parametry

  • szczegóły

    InjectDetails

    Szczegóły kodu CSS do wstawienia.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

isAudioMuted()

Chrome 62 lub nowszy 
chrome.webviewTag.isAudioMuted(
  callback: function,
)

Zapytania o to, czy dźwięk jest wyciszony.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (muted: boolean) => void

    • Wyciszono

      wartość logiczna

isSpatialNavigationEnabled()

Chrome 71 lub nowszy 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (enabled: boolean) => void

    • włączone

      wartość logiczna

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

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

loadDataWithBaseUrl()

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

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

Parametry

  • dataUrl

    ciąg znaków

    Adres URL danych do załadowania.

  • baseUrl

    ciąg znaków

    Podstawowy adres URL, który będzie używany do linków 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()

Wypisuje zawartość pliku webview. Jest to równoważne wywołaniu funkcji wydruku skryptu z poziomu webview.

reload()

chrome.webviewTag.reload()

Ponowne załadowanie bieżącej strony najwyższego poziomu.

removeContentScripts()

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

Usuwa skrypty treści z webview.

W tym przykładzie usuwamy regułę „myRule”, która została dodana wcześniej.

webview.removeContentScripts(['myRule']);

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

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 webview zostaną usunięte.

setAudioMuted()

Chrome 62 lub nowszy 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

Ustawia stan wyciszenia dźwięku w widoku internetowym.

Parametry

  • wycisz

    wartość logiczna

    Wartość wyciszenia dźwięku

setSpatialNavigationEnabled()

Chrome 71 lub nowszy 
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

Ustawia stan nawigacji przestrzennej w elementie webview.

Parametry

  • włączone

    wartość logiczna

    Wartość stanu nawigacji przestrzennej.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

Zastąpić ciąg znaków klienta użytkownika używany przez webview w przypadku żądań strony gościa. Zastąpienie spowoduje, że wartości nagłówka User-Agent Client Hints i wartości zwracane przez navigator.userAgentData będą puste w przypadku żądań strony gościa, do których zastąpienie jest stosowane.

Parametry

  • userAgent

    ciąg znaków

    Ciąg znaków klienta użytkownika, którego chcesz użyć.

setZoom()

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

Zmienia współczynnik powiększenia strony. Zakres i trwałość tej zmiany są określane przez bieżący tryb powiększenia widoku przeglądarki (patrz webviewTag.ZoomMode).

Parametry

  • zoomFactor

    liczba

    Nowy współczynnik powiększenia.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

setZoomMode()

Chrome 43 lub nowszy 
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

Ustawia tryb powiększenia webview.

Parametry

  • ZoomMode

    ZoomMode

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

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

stop()

chrome.webviewTag.stop()

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

stopFinding()

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

Kończy bieżącą sesję wyszukiwania (czyszcząc wszystkie wyróżnienia) 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 wyszukiwania. clear powoduje usunięcie podświetlenia aktywnego dopasowania; keep zachowuje podświetlenie aktywnego dopasowania; activate zachowuje podświetlenie aktywnego dopasowania i symuluje kliknięcie przez użytkownika tego dopasowania. Domyślne działanie to keep.

terminate()

chrome.webviewTag.terminate()

Wymuszone zakończenie procesu mechanizmu renderowania strony internetowej gościa. Może to mieć wpływ na wiele tagów webview w bieżącej aplikacji, jeśli korzystają one z tego samego procesu, ale nie będzie to miało wpływu na tagi webview w innych aplikacjach.

Wydarzenia

close

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

Wywoływany, gdy okno gościa próbuje się zamknąć.

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

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    () => void

consolemessage

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

Uruchamiane, gdy okno gościa rejestruje wiadomość konsoli.

Poniższy przykładowy kod przekazuje wszystkie komunikaty logowania do konsoli twórcy bez względu na poziom logowania ani 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 ma postać:

    (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 wywoła zdarzenie load, czyli gdy wczytuje się nowy dokument. Nie obejmuje to nawigacji po stronach w bieżącym dokumencie ani asynchronicznego wczytywania zasobów.

Podany niżej przykładowy kod zmienia domyślny rozmiar czcionki elementu body gościa po załadowaniu strony:

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    () => void

dialog

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

Wywoływane, 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, gdy każdy detektor zdarzeń zwróci wartość lub obiekt dialog stanie się niedostępny (jeśli wywołano funkcję preventDefault()).

Domyślnie okno dialogowe jest anulowane.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

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

    • messageType

      „alert”
       | „confirm”
       | „prompt”

    • messageText

      ciąg znaków

    • okno|okno dialogowe

      DialogController

exit

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

Wywoływane po zakończeniu procesu renderowania treści internetowych dla gości.

Ten przykładowy kod spowoduje wyświetlenie pożegnalnego komunikatu, gdy strona dla gości 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 ma postać:

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

    • processID

      liczba

    • reason

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

findupdate

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

Uruchamiane, gdy dostępne są nowe wyniki wyszukiwania dla aktywnego żądania wyszukiwania. Może się to zdarzyć wielokrotnie w przypadku pojedynczego żądania znajdowania, gdy znajdują się dopasowania.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

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

    • searchText

      ciąg znaków

    • numberOfMatches

      liczba

    • activeMatchOrdinal

      liczba

    • selectionRect

      SelectionRect

    • anulowano

      wartość logiczna

    • finalUpdate

      ciąg znaków

loadabort

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

Wywoływany, gdy wczytywanie na najwyższym poziomie zostało przerwane bez zatwierdzenia. Komunikat o błędzie zostanie wydrukowany na konsoli, chyba że zdarzenie jest domyślnie blokowane.

Uwaga: gdy wczytywanie zasobów zostanie przerwane, po zdarzeniu loadabort nastąpi w końcu zdarzenie loadstop, nawet jeśli wszystkie zainicjowane wczytania od ostatniego zdarzenia loadstop (jeśli w ogóle wystąpiło) zostały przerwane.

Uwaga: gdy wczytywanie adresu URL about lub adresu URL JavaScript zostanie przerwane, zostanie wywołana funkcja loadabort, a następnie element webview przejdzie do adresu „about:blank”.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (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

    • 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"

loadcommit

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

Wywoływane po zaakceptowaniu załadowania. Obejmuje to nawigację w bieżącym dokumencie oraz wczytywanie na poziomie dokumentu podramki, ale nie obejmuje asynchronicznego wczytywania zasobów.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

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

    • URL

      ciąg znaków

    • isTopLevel

      wartość logiczna

loadredirect

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

Wywoływany, gdy żądanie wczytania na najwyższym poziomie zostało przekierowane do innego adresu URL.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (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, gdy rozpoczęło się wczytywanie.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

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

    • URL

      ciąg znaków

    • isTopLevel

      wartość logiczna

loadstop

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

Wyzwalany po zakończeniu wszystkich wczytań na poziomie ramki na stronie gościa (w tym wszystkich jej ramek podrzędnych). Obejmuje to nawigację w bieżącym dokumencie oraz wczytywanie na poziomie dokumentu podramki, ale nie obejmuje asynchronicznego wczytywania zasobów. To zdarzenie jest wywoływane za każdym razem, gdy liczba wczytań na poziomie dokumentu zmienia się z co najmniej 1 na 0. Jeśli np. strona, która już się załadowała (czyli loadstop już raz uruchomione) tworzy nowy element iframe, który wczytuje stronę, a po zakończeniu wczytywania strony iframe uruchamia się drugie loadstop. Ten wzór jest często obserwowany na stronach, na których wczytują się reklamy.

Uwaga: gdy wczytanie zapisane w pamięci podręcznej zostanie przerwane, po zdarzeniu loadabort nastąpi zdarzenie loadstop, nawet jeśli wszystkie wczytania zapisane w pamięci podręcznej od ostatniego zdarzenia loadstop (jeśli w ogóle wystąpiło) zostały przerwane.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    () => void

newwindow

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

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

Ten przykładowy kod utworzy nowe webview w elementach embedder i przejdzie do nich 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 ma postać:

    (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

      NewWindow

    • targetUrl

      ciąg znaków

    • initialWidth

      liczba

    • initialHeight

      liczba

    • nazwa

      ciąg znaków

    • windowOpenDisposition

      "ignore"
       | "save_to_disk"
       | "current_tab"
       | "new_background_tab"
       | "new_foreground_tab"
       | "new_window"
       | "new_popup"

permissionrequest

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

Wywoływany, gdy strona gościa musi poprosić o specjalne uprawnienia od osoby umieszczającej.

Poniższy przykładowy kod przyzna stronie gościa dostęp do interfejsu API webkitGetUserMedia. Pamiętaj, że aplikacja korzystająca z tego przykładowego kodu musi sama określić uprawnienia pliku manifestu audioCapture lub videoCapture:

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (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,
)

Wywoływany, gdy proces renderowania treści internetowych gościa znów reaguje po tym, jak przestał reagować.

Poniższy przykładowy kod powoduje stopniowe pojawianie się lub znikanie elementu webview w miarę jego aktywacji lub dezaktywacji:

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 ma postać:

    (processID: number) => void

    • processID

      liczba

sizechanged

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

Wywoływany, gdy rozmiar załączonych treści internetowych został zmieniony za pomocą elementu autosize. Występuje tylko wtedy, gdy autosize jest włączona.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

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

    • oldWidth

      liczba

    • oldHeight

      liczba

    • newWidth

      liczba

    • newHeight

      liczba

unresponsive

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

Wywoływany, gdy proces renderowania treści internetowych gościa przestał odpowiadać. Jeśli gość ponownie zacznie odpowiadać, to zdarzenie zostanie wygenerowane raz z odpowiednim zdarzeniem odpowiedzi.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (processID: number) => void

    • processID

      liczba

zoomchange

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

Wywoływane, gdy zmienia się powiększenie strony.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

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

    • oldZoomFactor

      liczba

    • newZoomFactor

      liczba