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

    OnClickData

    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

    OnClickData

    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

  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.

Typ

ContentWindow

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.

Typ

ContextMenus

request

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

Typ

WebRequestEventInterface

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

• contentScriptList

  [ContentScriptDetails, ...ContentScriptDetails[]]

  Szczegóły skryptów treści, które chcesz dodać.

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

  ClearDataOptions

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

• typy

  ClearDataTypeSet

  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

  InjectDetails

  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

    Opcjonalne FindCallbackResults

    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

    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

  InjectDetails

  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

  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

    DialogController

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

    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

    NewWindow

  • 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