chrome.webviewTag

Mô tả

Sử dụng thẻ webview để chủ động tải nội dung trực tiếp từ web qua mạng và nhúng nội dung đó vào Ứng dụng Chrome. Ứng dụng của bạn có thể kiểm soát sự xuất hiện của webview và tương tác với nội dung web, bắt đầu các thao tác điều hướng trong trang web được nhúng, phản ứng với các sự kiện lỗi xảy ra trong trang web đó và nhiều thao tác khác (xem phần Cách sử dụng).

Quyền

webview

Loại

ClearDataOptions

Các tuỳ chọn xác định dữ liệu nào sẽ bị clearData xoá.

Thuộc tính

  • từ

    số không bắt buộc

    Xoá dữ liệu được tích luỹ vào hoặc sau ngày này, được biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống (có thể truy cập qua phương thức getTime của đối tượng Date JavaScript). Nếu không có, chế độ mặc định sẽ là 0 (sẽ xoá tất cả dữ liệu duyệt web).

ClearDataTypeSet

Một tập hợp các loại dữ liệu. Các thuộc tính bị thiếu sẽ được hiểu là false.

Thuộc tính

  • bộ nhớ đệm của ứng dụng

    boolean không bắt buộc

    Trang web bộ nhớ đệm ứng dụng.

  • bộ nhớ đệm

    boolean không bắt buộc

    Chrome 44 trở lên

    Kể từ Chrome 43. Bộ nhớ đệm của trình duyệt. Lưu ý: khi xoá dữ liệu, thao tác này sẽ xoá toàn bộ bộ nhớ đệm; ký tự đó không bị giới hạn ở phạm vi mà bạn chỉ định.

  • cookie

    boolean không bắt buộc

    Cookie của phân vùng.

  • fileSystems

    boolean không bắt buộc

    Trang web hệ thống tệp.

  • indexedDB

    boolean không bắt buộc

    Trang web Dữ liệu IndexedDB.

  • localStorage

    boolean không bắt buộc

    Trang web dữ liệu lưu trữ cục bộ.

  • persistentCookies

    boolean không bắt buộc

    Chrome 58 trở lên

    Cookie cố định của phân vùng.

  • sessionCookies

    boolean không bắt buộc

    Chrome 58 trở lên

    Cookie phiên của phân vùng.

  • webSQL

    boolean không bắt buộc

    Trang web Dữ liệu WebSQL.

ContentScriptDetails

Chrome 44 trở lên

Chi tiết về tập lệnh nội dung cần chèn. Tham khảo tài liệu về tập lệnh nội dung để biết thêm chi tiết.

Thuộc tính

  • all_frames

    boolean không bắt buộc

    Nếu all_framestrue, điều này có nghĩa là JavaScript hoặc CSS cần được chèn vào tất cả khung của trang hiện tại. Theo mặc định, all_framesfalse và JavaScript hoặc CSS chỉ được chèn vào khung trên cùng.

  • css

    InjectionItems không bắt buộc

    Mã CSS hoặc danh sách các tệp CSS sẽ được chèn vào các trang phù hợp. Các mô-đun này được đưa vào theo thứ tự xuất hiện trước khi bất kỳ DOM nào được xây dựng hoặc hiển thị cho trang đó.

  • exclude_globs

    string[] không bắt buộc

    Được áp dụng sau khi so khớp để loại trừ những URL khớp với cụm cầu này. Nhằm mô phỏng từ khoá @excluded Grease sao.

  • exclude_matches

    string[] không bắt buộc

    Không bao gồm các trang mà tập lệnh nội dung này sẽ được chèn vào.

  • include_globs

    string[] không bắt buộc

    Được áp dụng sau các kết quả trùng khớp để chỉ bao gồm những URL cũng khớp với cụm cầu này. Nhằm mô phỏng từ khoá @include Greasesh.

  • JavaScript

    InjectionItems không bắt buộc

    Mã JavaScript hoặc danh sách tệp JavaScript sẽ được chèn vào các trang phù hợp. Các biến này được chèn theo thứ tự xuất hiện.

  • match_about_blank

    boolean không bắt buộc

    Liệu có chèn tập lệnh nội dung vào about:blank và about:srcdoc hay không. Tập lệnh nội dung sẽ chỉ được đưa vào các trang khi URL kế thừa của chúng khớp với một trong các mẫu đã khai báo trong trường so khớp. URL kế thừa là URL của tài liệu đã tạo khung hoặc cửa sổ. Không thể chèn tập lệnh nội dung vào khung hộp cát.

  • khớp với

    chuỗi[]

    Chỉ định những trang mà tập lệnh nội dung này sẽ được chèn vào.

  • tên

    string

    Tên của tập lệnh nội dung cần chèn.

  • run_at

    RunAt không bắt buộc

    Thời điểm sớm nhất mà JavaScript hoặc CSS sẽ được chèn vào thẻ. Giá trị mặc định là "document_idle".

ContentWindow

Ô điều khiển nhắn tin tới cửa sổ khách.

Thuộc tính

  • postMessage

    void

    Đăng thông báo lên nội dung web được nhúng, miễn là nội dung được nhúng vẫn hiển thị một trang từ nguồn gốc đích. Bạn có thể sử dụng phương thức này sau khi trang tải xong. Theo dõi sự kiện contentload rồi gọi phương thức này.

    Khách có thể gửi tin nhắn trả lời cho người nhúng bằng cách đăng tin nhắn lên event.source trong sự kiện tin nhắn mà họ nhận được.

    API này giống với API HTML5 postMessage để giao tiếp giữa các trang web. Trình nhúng có thể theo dõi các phản hồi bằng cách thêm trình nghe sự kiện message vào khung của chính trình nghe đó.

    Hàm postMessage có dạng như sau:

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

    • tin nhắn

      bất kỳ

      Đối tượng tin nhắn để gửi cho khách.

    • targetOrigin

      string

      Chỉ định nguồn gốc của cửa sổ khách để điều phối sự kiện.

ContextMenuCreateProperties

Chrome 44 trở lên

Thuộc tính

  • đã chọn

    boolean không bắt buộc

    Trạng thái ban đầu của hộp đánh dấu hoặc mục radio: true nếu đã chọn và false nếu đã bỏ chọn. Bạn chỉ có thể chọn một mục chọn tại một thời điểm trong một nhóm mục chọn.

  • bối cảnh

    [ContextType, ...ContextType[]] không bắt buộc

    Danh sách các bối cảnh mà mục này trong trình đơn sẽ xuất hiện. Giá trị mặc định là ['page'] nếu không được chỉ định.

  • documentUrlPatterns

    string[] không bắt buộc

    Cho phép bạn giới hạn mục để chỉ áp dụng cho các tài liệu có URL khớp với một trong các mẫu cho trước. (Điều này cũng áp dụng cho khung hình.) Để biết thông tin chi tiết về định dạng của mẫu, hãy xem So khớp mẫu.

  • đang bật

    boolean không bắt buộc

    Liệu mục trình đơn theo bối cảnh này đang bật hay tắt. Giá trị mặc định là true.

  • id

    chuỗi không bắt buộc

    Mã nhận dạng duy nhất để gán cho mục này. Bắt buộc đối với các trang sự kiện. Không được giống với một mã khác cho tiện ích này.

  • parentId

    string | số không bắt buộc

    Mã của một mục trong trình đơn gốc; thao tác này sẽ làm cho mục này trở thành phần tử con của mục đã thêm trước đó.

  • targetUrlPatterns

    string[] không bắt buộc

    Tương tự như documentUrlPatterns nhưng cho phép bạn lọc dựa trên thuộc tính src của thẻ img/audio/video và href của thẻ ký tự liên kết.

  • tiêu đề

    chuỗi không bắt buộc

    Văn bản sẽ xuất hiện trong mặt hàng; đây là bắt buộc trừ khi type là "dấu phân cách". Khi ngữ cảnh là "lựa chọn", bạn có thể dùng %s trong chuỗi để hiện văn bản đã chọn. Ví dụ: nếu giá trị của thông số này là "Dịch '%s' thành Pig Latin" và người dùng chọn từ "tuyệt vời", mục trong trình đơn theo bối cảnh để lựa chọn là "Dịch "tuyệt vời" cho Pig Latin".

  • loại

    ItemType không bắt buộc

    Loại mục trong trình đơn. Giá trị mặc định là "bình thường" nếu không được chỉ định.

  • onclick

    khoảng trống không bắt buộc

    Một hàm sẽ được gọi lại khi người dùng nhấp vào một mục trong trình đơn.

    Hàm onclick có dạng như sau:

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

    • Thông tin về mặt hàng được nhấp vào và bối cảnh nơi xảy ra lượt nhấp.

ContextMenus

Chrome 44 trở lên

Thuộc tính

  • onShow

    Sự kiện<functionvoidvoid>

    Được kích hoạt trước khi hiển thị trình đơn theo bối cảnh trên webview này. Bạn có thể dùng để tắt trình đơn theo bối cảnh này bằng cách gọi event.preventDefault().

    Hàm onShow.addListener có dạng như sau:

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

    • số gọi lại

      hàm

      Tham số callback sẽ có dạng như sau:

      (event: object) => void

      • event

        đối tượng

        • preventDefault

          void

          Gọi lệnh này để ngăn hiển thị trình đơn theo bối cảnh.

          Hàm preventDefault có dạng như sau:

          () => {...}

  • create

    void

    Tạo một mục mới trong trình đơn theo bối cảnh. Xin lưu ý rằng nếu xảy ra lỗi trong quá trình tạo, thì bạn có thể không biết được cho đến khi lệnh gọi lại tạo kích hoạt (thông tin chi tiết sẽ có trong runtime.lastError).

    Hàm create có dạng như sau:

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

    • createProperties

      đối tượng

      Các thuộc tính dùng để tạo mục này

    • số gọi lại

      hàm không bắt buộc

      Tham số callback sẽ có dạng như sau:

      () => void

    • returns

      string | số

      Mã của mục mới tạo.

  • xoá

    void

    Xoá một mục trong trình đơn theo bối cảnh.

    Hàm remove có dạng như sau:

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

    • menuItemId

      string | số

      Mã của mục trong trình đơn theo bối cảnh cần xoá.

    • số gọi lại

      hàm không bắt buộc

      Tham số callback sẽ có dạng như sau:

      () => void

  • xoáTất cả

    void

    Xoá tất cả mục trong trình đơn theo bối cảnh đã thêm vào webview này.

    Hàm removeAll có dạng như sau:

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

    • số gọi lại

      hàm không bắt buộc

      Tham số callback sẽ có dạng như sau:

      () => void

  • cập nhật

    void

    Cập nhật một mục trong trình đơn theo bối cảnh đã tạo trước đó.

    Hàm update có dạng như sau:

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

    • id

      string | số

      Mã của mặt hàng cần cập nhật.

    • updateProperties

      đối tượng

      Các thuộc tính cần cập nhật. Chấp nhận các giá trị giống với hàm create.

    • số gọi lại

      hàm không bắt buộc

      Tham số callback sẽ có dạng như sau:

      () => void

ContextMenuUpdateProperties

Chrome 44 trở lên

Thuộc tính

  • đã chọn

    boolean không bắt buộc

    Trạng thái của hộp đánh dấu hoặc mục radio: true nếu đã chọn và false nếu đã bỏ chọn. Bạn chỉ có thể chọn một mục chọn tại một thời điểm trong một nhóm mục chọn.

  • bối cảnh

    [ContextType, ...ContextType[]] không bắt buộc

    Danh sách các bối cảnh mà mục này trong trình đơn sẽ xuất hiện.

  • documentUrlPatterns

    string[] không bắt buộc

    Cho phép bạn giới hạn mục để chỉ áp dụng cho các tài liệu có URL khớp với một trong các mẫu cho trước. (Điều này cũng áp dụng cho khung hình.) Để biết thông tin chi tiết về định dạng của mẫu, hãy xem So khớp mẫu.

  • đang bật

    boolean không bắt buộc

    Liệu mục trình đơn theo bối cảnh này đang bật hay tắt.

  • parentId

    string | số không bắt buộc

    Mã của một mục trong trình đơn gốc; thao tác này sẽ làm cho mục này trở thành phần tử con của mục đã thêm trước đó. Lưu ý: Bạn không thể thay đổi một mục thành phần tử con của một trong các phần tử con của chính mục đó.

  • targetUrlPatterns

    string[] không bắt buộc

    Tương tự như documentUrlPatterns nhưng cho phép bạn lọc dựa trên thuộc tính src của thẻ img/audio/video và href của thẻ ký tự liên kết.

  • tiêu đề

    chuỗi không bắt buộc

    Văn bản sẽ xuất hiện trong mặt hàng

  • loại

    ItemType không bắt buộc

    Loại mục trong trình đơn.

  • onclick

    khoảng trống không bắt buộc

    Một hàm sẽ được gọi lại khi người dùng nhấp vào một mục trong trình đơn.

    Hàm onclick có dạng như sau:

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

    • Thông tin về mặt hàng được nhấp vào và bối cảnh nơi xảy ra lượt nhấp.

ContextType

Chrome 44 trở lên

Các ngữ cảnh khác nhau mà một trình đơn có thể xuất hiện. Chỉ định "tất cả" tương đương với sự kết hợp của tất cả các ngữ cảnh khác.

Enum

"tất cả"

"trang"

"khung"

"selection"

"link"

"chỉnh sửa"

"hình ảnh"

"video"

"audio"

DialogController

Giao diện được đính kèm với dialog sự kiện DOM.

Thuộc tính

  • hủy

    void

    Từ chối hộp thoại. Tương đương với việc nhấp vào Huỷ trong hộp thoại confirm hoặc prompt.

    Hàm cancel có dạng như sau:

    () => {...}

  • ok

    void

    Chấp nhận hộp thoại. Tương đương với việc nhấp vào OK trong hộp thoại alert, confirm hoặc prompt.

    Hàm ok có dạng như sau:

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

    • phản hồi

      chuỗi không bắt buộc

      Chuỗi phản hồi cần cung cấp cho khách khi chấp nhận hộp thoại prompt.

DownloadPermissionRequest

Loại đối tượng request đi kèm với sự kiện DOM download permissionrequest.

Thuộc tính

  • requestMethod

    string

    Loại yêu cầu HTTP (ví dụ: GET) được liên kết với yêu cầu tải xuống.

  • url

    string

    URL tải xuống được yêu cầu.

  • allow

    void

    Cho phép yêu cầu quyền.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi allow.

    Hàm deny có dạng như sau:

    () => {...}

FileSystemPermissionRequest

Loại đối tượng request đi kèm với sự kiện DOM filesystem permissionrequest.

Thuộc tính

  • url

    string

    URL của khung yêu cầu quyền truy cập vào hệ thống tệp cục bộ.

  • allow

    void

    Cho phép yêu cầu quyền.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền.

    Hàm deny có dạng như sau:

    () => {...}

FindCallbackResults

Chứa tất cả kết quả của yêu cầu tìm.

Thuộc tính

  • activeMatchOrdinal

    số

    Số thứ tự của kết quả trùng khớp hiện tại.

  • đã huỷ

    boolean

    Cho biết liệu yêu cầu tìm này có bị huỷ hay không.

  • numberOfMatches

    số

    Số lần searchText được khớp trên trang.

  • selectionRect

    Mô tả một hình chữ nhật xung quanh kết quả trùng khớp chủ động trong toạ độ màn hình.

FindOptions

Các lựa chọn dành cho yêu cầu tìm.

Thuộc tính

  • phía sau

    boolean không bắt buộc

    Gắn cờ để tìm các kết quả trùng khớp theo thứ tự đảo ngược. Giá trị mặc định là false.

  • matchCase

    boolean không bắt buộc

    Gắn cờ để khớp với phân biệt chữ hoa chữ thường. Giá trị mặc định là false.

FullscreenPermissionRequest

Chrome 43 trở lên

Loại request đi kèm với sự kiện DOM fullscreen permissionrequest.

Thuộc tính

  • nguồn gốc

    string

    Nguồn gốc của khung bên trong webview đã khởi tạo yêu cầu toàn màn hình.

  • allow

    void

    Cho phép yêu cầu quyền.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền.

    Hàm deny có dạng như sau:

    () => {...}

GeolocationPermissionRequest

Loại đối tượng request đi kèm với sự kiện DOM geolocation permissionrequest.

Thuộc tính

  • url

    string

    URL của khung yêu cầu quyền truy cập vào dữ liệu định vị vị trí.

  • allow

    void

    Cho phép yêu cầu quyền.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi allow.

    Hàm deny có dạng như sau:

    () => {...}

HidPermissionRequest

Chrome 125 trở lên

Loại đối tượng request đi kèm với sự kiện DOM hid permissionrequest.

Thuộc tính

  • url

    string

    URL của khung yêu cầu quyền truy cập vào HID API.

  • allow

    void

    Cho phép yêu cầu quyền.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi allow.

    Hàm deny có dạng như sau:

    () => {...}

InjectDetails

Thông tin chi tiết về tập lệnh hoặc CSS cần chèn. Bạn phải đặt mã hoặc thuộc tính tệp, nhưng không được đặt cả hai mã cùng một lúc.

Thuộc tính

  • chuỗi không bắt buộc

    JavaScript hoặc mã CSS cần chèn.

    Cảnh báo: Hãy thận trọng khi sử dụng tham số code. Việc sử dụng sai cách đoạn mã này có thể khiến ứng dụng của bạn gặp phải các cuộc tấn công tập lệnh trên nhiều trang web.

  • tệp

    chuỗi không bắt buộc

    JavaScript hoặc CSS cần chèn.

InjectionItems

Chrome 44 trở lên

Loại mục chèn: mã hoặc một tập hợp tệp.

Thuộc tính

  • chuỗi không bắt buộc

    Mã JavaScript hoặc CSS để chèn vào các trang phù hợp.

  • tệp

    string[] không bắt buộc

    Danh sách các tệp JavaScript hoặc CSS sẽ được chèn vào các trang phù hợp. Các biến này được chèn theo thứ tự xuất hiện trong mảng này.

LoadPluginPermissionRequest

Loại đối tượng request đi kèm với sự kiện DOM loadplugin permissionrequest.

Thuộc tính

  • giá trị nhận dạng

    string

    Chuỗi giá trị nhận dạng của trình bổ trợ.

  • tên

    string

    Tên hiển thị của trình bổ trợ.

  • allow

    void

    Cho phép yêu cầu quyền. Đây là hành vi mặc định nếu không gọi deny.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền.

    Hàm deny có dạng như sau:

    () => {...}

MediaPermissionRequest

Loại đối tượng request đi kèm với sự kiện DOM media permissionrequest.

Thuộc tính

  • url

    string

    URL của khung yêu cầu quyền truy cập vào nội dung nghe nhìn của người dùng.

  • allow

    void

    Cho phép yêu cầu quyền.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi allow.

    Hàm deny có dạng như sau:

    () => {...}

NewWindow

Giao diện được đính kèm với newwindow sự kiện DOM.

Thuộc tính

  • đính kèm

    void

    Đính kèm trang đích được yêu cầu vào một phần tử webview hiện có.

    Hàm attach có dạng như sau:

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

    • chế độ xem web

      đối tượng

      Phần tử webview cần đính kèm vào trang đích.

  • hủy

    void

    Huỷ yêu cầu về cửa sổ mới.

    Hàm discard có dạng như sau:

    () => {...}

PointerLockPermissionRequest

Loại request đi kèm với sự kiện DOM pointerLock permissionrequest.

Thuộc tính

  • lastUnlockedBySelf

    boolean

    Khung yêu cầu có phải là ứng dụng gần đây nhất có khoá con trỏ hay không.

  • url

    string

    URL của khung yêu cầu khoá con trỏ.

  • userGesture

    boolean

    Liệu có yêu cầu khoá con trỏ do cử chỉ nhập của người dùng hay không.

  • allow

    void

    Cho phép yêu cầu quyền.

    Hàm allow có dạng như sau:

    () => {...}

  • từ chối

    void

    Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi allow.

    Hàm deny có dạng như sau:

    () => {...}

SelectionRect

Mô tả một hình chữ nhật trong toạ độ màn hình.

Ngữ nghĩa ngăn chặn giống như mảng; tức là toạ độ (left, top) được coi là nằm trong hình chữ nhật, nhưng toạ độ (left + width, top) thì không.

Thuộc tính

  • độ cao

    số

    Chiều cao của hình chữ nhật.

  • trái

    số

    Khoảng cách từ cạnh trái của màn hình đến cạnh trái của hình chữ nhật.

  • trên cùng

    số

    Khoảng cách từ cạnh trên của màn hình đến cạnh trên của hình chữ nhật.

  • chiều rộng

    số

    Chiều rộng của hình chữ nhật.

WebRequestEventInterface

Chrome 44 trở lên

Giao diện cấp quyền truy cập vào các sự kiện webRequest trên trang khách. Xem API tiện ích chrome.webRequest để biết thông tin chi tiết về vòng đời webRequest và các khái niệm có liên quan. Lưu ý: Sự kiện chrome.webRequest.onActionIgnored không được hỗ trợ cho webview.

Để minh hoạ sự khác biệt giữa việc sử dụng và API webRequest của tiện ích, hãy xem xét mã mẫu sau đây giúp chặn mọi yêu cầu của khách đối với các URL khớp với *://www.evil.com/*:

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

Ngoài ra, giao diện này hỗ trợ các quy tắc webRequest khai báo thông qua các sự kiện onRequestonMessage. Hãy xem declarativeWebRequest để biết thông tin chi tiết về API.

Xin lưu ý rằng các điều kiện và hành động cho webRequest khai báo phải được tạo thực thể từ các phiên bản tương ứng trong chrome.webViewRequest.*. Mã ví dụ sau đây tuyên bố chặn tất cả các yêu cầu đến "example.com" trên 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 43 trở lên

Xác định cách xử lý thao tác thu phóng trong webview.

Enum

"mỗi nguồn gốc"
Những thay đổi của tính năng thu phóng sẽ được duy trì trong nguồn gốc của trang được thu phóng, tức là tất cả các webview khác trong cùng một phân vùng được điều hướng đến cùng nguồn gốc đó cũng sẽ được thu phóng. Ngoài ra, các thay đổi về mức thu phóng per-origin được lưu cùng với nguồn gốc, nghĩa là khi chuyển đến các trang khác ở cùng nguồn gốc, tất cả các trang đó sẽ được thu phóng về cùng một hệ số thu phóng.

"trên mỗi chế độ xem"
Các thay đổi đối với chế độ thu phóng chỉ có hiệu lực trong chế độ xem web này và những thay đổi về chế độ thu phóng trong các chế độ xem web khác sẽ không ảnh hưởng đến việc thu phóng của chế độ xem web này. Ngoài ra, những thay đổi về mức thu phóng của per-view sẽ được đặt lại trong quá trình điều hướng; việc di chuyển trong một chế độ xem web sẽ luôn tải trang có hệ số thu phóng trên mỗi nguồn gốc (trong phạm vi của phân vùng).

"disabled"
Tắt tất cả tính năng thu phóng trong chế độ xem web. Nội dung sẽ quay về mức thu phóng mặc định và mọi thay đổi mà bạn thực hiện để thu phóng sẽ bị bỏ qua.

Thuộc tính

contentWindow

Tham chiếu đối tượng có thể dùng để đăng thông báo lên trang khách.

Loại

contextMenus

Chrome 44 trở lên

Tương tự như API ContextMenus của Chrome, nhưng áp dụng cho webview thay vì trình duyệt. Dùng API webview.contextMenus để thêm mục vào trình đơn theo bối cảnh của webview. Bạn có thể chọn loại đối tượng mà phần bổ sung của trình đơn theo bối cảnh sẽ áp dụng, chẳng hạn như hình ảnh, siêu liên kết và trang.

Loại

request

Giao diện cấp quyền truy cập vào các sự kiện webRequest trên trang khách.

Phương thức

addContentScripts()

Chrome 44 trở lên
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)

Thêm quy tắc chèn tập lệnh nội dung vào webview. Khi webview chuyển đến một trang phù hợp với một hoặc nhiều quy tắc, thì các tập lệnh liên quan sẽ được đưa vào. Bạn có thể lập trình để thêm quy tắc hoặc cập nhật quy tắc hiện có.

Ví dụ sau sẽ thêm hai quy tắc vào webview: 'myRule' và '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';

Bạn có thể trì hoãn lệnh gọi addContentScripts cho đến khi cần chèn các tập lệnh.

Ví dụ sau đây trình bày cách ghi đè quy tắc hiện có.

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'}]);

Nếu webview đã được điều hướng đến nguồn gốc (ví dụ: foo.com) và gọi webview.addContentScripts để thêm "myRule", thì bạn cần phải đợi thao tác điều hướng tiếp theo để các tập lệnh được chèn. Nếu bạn muốn chèn ngay lập tức, executeScript sẽ hoạt động đúng cách.

Các quy tắc được giữ nguyên ngay cả khi quy trình khách gặp sự cố hoặc bị tắt hay ngay cả khi webview được gán lại cấp độ gốc.

Tham khảo tài liệu về tập lệnh nội dung để biết thêm chi tiết.

Tham số

back()

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

Di chuyển lùi lại một mục nhật ký nếu có thể. Tương đương với go(-1).

Tham số

  • số gọi lại

    hàm không bắt buộc

    Chrome 44 trở lên

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

      Cho biết liệu quá trình điều hướng có thành công hay không.

canGoBack()

chrome.webviewTag.canGoBack()

Cho biết liệu có thể di chuyển ngược lại thông qua nhật ký hay không. Trạng thái của hàm này được lưu vào bộ nhớ đệm và cập nhật trước mỗi loadcommit, vì vậy, vị trí tốt nhất để gọi hàm này là trên loadcommit.

Giá trị trả về

  • boolean

canGoForward()

chrome.webviewTag.canGoForward()

Cho biết có thể điều hướng tiếp theo trong lịch sử hay không. Trạng thái của hàm này được lưu vào bộ nhớ đệm và cập nhật trước mỗi loadcommit, vì vậy, vị trí tốt nhất để gọi hàm này là trên loadcommit.

Giá trị trả về

  • boolean

captureVisibleRegion()

Chrome 50 trở lên
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)

Chụp khu vực hiển thị của chế độ xem web.

Tham số

  • tùy chọn

    ImageDetails không bắt buộc

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (dataUrl: string) => void

    • dataUrl

      string

      Một URL dữ liệu mã hoá hình ảnh của khu vực hiển thị của thẻ được chụp. Có thể được chỉ định cho thuộc tính "src" thuộc tính của phần tử Hình ảnh HTML để hiển thị.

clearData()

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

Xoá dữ liệu duyệt web cho phân vùng webview.

Tham số

  • tùy chọn

    Các tuỳ chọn xác định dữ liệu cần xoá.

  • Loại dữ liệu cần xoá.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

executeScript()

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

Chèn mã JavaScript vào trang khách.

Mã mẫu sau đây dùng tính năng chèn tập lệnh để đặt màu nền của trang khách thành màu đỏ:

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

Tham số

  • chi tiết

    Thông tin chi tiết về tập lệnh cần chạy.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (result?: any[]) => void

    • kết quả

      bất kỳ[] không bắt buộc

      Kết quả của tập lệnh trong mỗi khung được chèn.

find()

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

Khởi tạo yêu cầu tìm trong trang.

Tham số

  • searchText

    string

    Chuỗi cần tìm trong trang.

  • tùy chọn

    FindOptions không bắt buộc

    Các lựa chọn dành cho yêu cầu tìm.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (results?: FindCallbackResults) => void

    • kết quả

      FindCallbackResults không bắt buộc

      Chứa tất cả kết quả của yêu cầu tìm. Bạn có thể bỏ qua results nếu không dùng hàm này trong phần nội dung của hàm callback; ví dụ: nếu lệnh gọi lại chỉ được dùng để xác định thời điểm yêu cầu tìm đã hoàn tất.

forward()

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

Di chuyển tiến tới một mục nhật ký nếu có thể. Tương đương với go(1).

Tham số

  • số gọi lại

    hàm không bắt buộc

    Chrome 44 trở lên

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

      Cho biết liệu quá trình điều hướng có thành công hay không.

getAudioState()

Chrome 62 trở lên
chrome.webviewTag.getAudioState(
  callback: function,
)

Trạng thái âm thanh của cụm từ tìm kiếm.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (audible: boolean) => void

    • audible

      boolean

getProcessId()

chrome.webviewTag.getProcessId()

Trả về mã quy trình nội bộ của Chrome cho quy trình hiện tại của trang web khách, cho phép người nhúng biết số lượng khách sẽ bị ảnh hưởng khi chấm dứt quá trình. Hai khách sẽ chỉ chia sẻ một quy trình nếu họ thuộc cùng một ứng dụng và có cùng mã phân vùng bộ nhớ. Lệnh gọi này có tính đồng bộ và trả về khái niệm đã lưu vào bộ nhớ đệm của người nhúng về mã nhận dạng tiến trình hiện tại. Mã tiến trình không giống với mã tiến trình của hệ điều hành.

Giá trị trả về

  • số

getUserAgent()

chrome.webviewTag.getUserAgent()

Trả về chuỗi tác nhân người dùng mà webview sử dụng cho các yêu cầu trên trang khách.

Giá trị trả về

  • string

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)

Lấy hệ số thu phóng hiện tại.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (zoomFactor: number) => void

    • zoomFactor

      số

      Hệ số thu phóng hiện tại.

getZoomMode()

Chrome 43 trở lên
chrome.webviewTag.getZoomMode(
  callback: function,
)

Xem chế độ thu phóng hiện tại.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      Chế độ thu phóng hiện tại của webview.

go()

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

Chuyển đến một mục nhật ký bằng chỉ mục nhật ký so với bảng điều hướng hiện tại. Nếu không thể điều hướng đã yêu cầu, thì phương thức này sẽ không có hiệu lực.

Tham số

  • relativeIndex

    số

    Chỉ mục nhật ký tương đối mà webview nên được điều hướng đến. Ví dụ: giá trị của 2 sẽ điều hướng tiến 2 mục nhập nhật ký nếu có thể; giá trị -3 sẽ điều hướng lùi lại 3 mục nhập.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

      Cho biết liệu quá trình điều hướng có thành công hay không.

insertCSS()

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

Chèn CSS vào trang khách.

Tham số

  • chi tiết

    Thông tin chi tiết về CSS cần chèn.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

isAudioMuted()

Chrome 62 trở lên
chrome.webviewTag.isAudioMuted(
  callback: function,
)

Truy vấn xem âm thanh có bị tắt tiếng hay không.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (muted: boolean) => void

    • đã tắt tiếng

      boolean

isSpatialNavigationEnabled()

Chrome 71 trở lên
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

Truy vấn xem bạn có bật tính năng điều hướng theo không gian cho WebView hay không.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (enabled: boolean) => void

    • đang bật

      boolean

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

Cho biết liệu chuỗi tác nhân người dùng của webview có bị webviewTag.setUserAgentOverride ghi đè hay không.

loadDataWithBaseUrl()

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

Tải một URL dữ liệu có URL cơ sở cụ thể dùng cho đường liên kết tương đối. Nếu muốn, bạn có thể cung cấp một URL ảo để người dùng thấy được thay vì URL dữ liệu.

Tham số

  • dataUrl

    string

    URL dữ liệu cần tải.

  • baseUrl

    string

    URL cơ sở sẽ dùng cho đường liên kết tương đối.

  • virtualUrl

    chuỗi không bắt buộc

    URL mà người dùng sẽ nhìn thấy (trong thanh địa chỉ).

print()

chrome.webviewTag.print()

In nội dung của webview. Điều này tương đương với việc gọi hàm in theo tập lệnh qua chính webview.

reload()

chrome.webviewTag.reload()

Tải lại trang cấp cao nhất hiện tại.

removeContentScripts()

Chrome 44 trở lên
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)

Xoá tập lệnh nội dung khỏi webview.

Ví dụ sau đây xóa "myRule" đã được thêm trước đó.

webview.removeContentScripts(['myRule']);

Bạn có thể xoá tất cả quy tắc bằng cách gọi:

webview.removeContentScripts();

Tham số

  • scriptNameList

    string[] không bắt buộc

    Danh sách tên của các tập lệnh nội dung sẽ bị xoá. Nếu danh sách này trống thì mọi tập lệnh nội dung đã thêm vào webview đều sẽ bị xoá.

setAudioMuted()

Chrome 62 trở lên
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

Đặt trạng thái tắt âm thanh của chế độ xem web.

Tham số

  • tắt tiếng

    boolean

    Tắt tiếng giá trị âm thanh

setSpatialNavigationEnabled()

Chrome 71 trở lên
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

Đặt trạng thái điều hướng không gian của chế độ xem web.

Tham số

  • đang bật

    boolean

    Giá trị trạng thái điều hướng không gian.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

Ghi đè chuỗi tác nhân người dùng mà webview sử dụng cho các yêu cầu trên trang khách. Việc ghi đè sẽ khiến các giá trị tiêu đề Gợi ý ứng dụng tác nhân người dùng và các giá trị do navigator.userAgentData trả về bị trống đối với các yêu cầu trang khách mà cơ chế ghi đè này sẽ được áp dụng.

Tham số

  • userAgent

    string

    Chuỗi tác nhân người dùng cần sử dụng.

setZoom()

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

Thay đổi hệ số thu phóng của trang. Phạm vi và khả năng duy trì của thay đổi này là do chế độ thu phóng hiện tại của chế độ xem web xác định (xem webviewTag.ZoomMode).

Tham số

  • zoomFactor

    số

    Hệ số thu phóng mới.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

setZoomMode()

Chrome 43 trở lên
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

Thiết lập chế độ thu phóng của webview.

Tham số

  • ZoomMode

    Xác định cách xử lý thao tác thu phóng trong webview.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

stop()

chrome.webviewTag.stop()

Dừng tải quá trình điều hướng webview hiện tại nếu đang diễn ra.

stopFinding()

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

Kết thúc phiên tìm hiện tại (xoá tất cả nội dung được đánh dấu) và huỷ tất cả các yêu cầu tìm đang thực hiện.

Tham số

  • hành động

    "xoá"
     | "keep"
     | "kích hoạt"
     không bắt buộc

    Xác định việc cần làm với kết quả trùng khớp đang diễn ra sau khi phiên tìm kiếm kết thúc. clear sẽ xoá phần đánh dấu nội dung được đánh dấu trong trận đấu đang diễn ra; keep sẽ làm nổi bật kết quả trùng khớp đang hoạt động; activate sẽ làm nổi bật kết quả trùng khớp đang hoạt động và mô phỏng hoạt động nhấp của người dùng vào kết quả trùng khớp đó. Thao tác mặc định là keep.

terminate()

chrome.webviewTag.terminate()

Buộc tắt quy trình kết xuất đồ hoạ của trang web khách. Việc này có thể ảnh hưởng đến nhiều thẻ webview trong ứng dụng hiện tại nếu các thẻ đó áp dụng cùng một quy trình, nhưng sẽ không ảnh hưởng đến các thẻ webview trong các ứng dụng khác.

Sự kiện

close

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

Được kích hoạt khi cửa sổ khách cố gắng tự đóng.

Mã ví dụ sau đây điều hướng webview đến about:blank khi khách cố gắng tự đóng.

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    () => void

consolemessage

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

Được kích hoạt khi cửa sổ khách ghi lại thông báo trên bảng điều khiển.

Mã ví dụ sau đây chuyển tiếp tất cả thông điệp nhật ký đến bảng điều khiển của người nhúng mà không quan tâm đến cấp độ nhật ký hoặc các thuộc tính khác.

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • cấp lần truy cập,

      số

    • tin nhắn

      string

    • dòng

      số

    • sourceId

      string

contentload

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

Được kích hoạt khi cửa sổ khách kích hoạt một sự kiện load, tức là khi tài liệu mới được tải. Thao tác này không bao gồm thao tác điều hướng trang trong tài liệu hiện tại hoặc các lượt tải tài nguyên không đồng bộ.

Mã ví dụ sau đây sửa đổi kích thước phông chữ mặc định của phần tử body của khách sau khi tải trang:

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    () => void

dialog

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

Được kích hoạt khi cửa sổ khách cố gắng mở hộp thoại phương thức qua window.alert, window.confirm hoặc window.prompt.

Việc xử lý sự kiện này sẽ chặn quy trình khách cho đến khi từng trình nghe sự kiện trả về hoặc đối tượng dialog không thể truy cập được (nếu preventDefault() được gọi).

Hành vi mặc định là huỷ hộp thoại.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • messageType

      "cảnh báo"
       | "xác nhận"
       | "prompt"

    • messageText

      string

    • hộp thoại

exit

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

Được kích hoạt khi quá trình kết xuất nội dung web khách đã thoát.

Mã ví dụ sau đây sẽ hiển thị thông báo tạm biệt bất cứ khi nào trang khách gặp sự cố:

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • processID

      số

    • lý do

      "bình thường"
       | "bất thường"
       | "sự cố"
       | "giết"

findupdate

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

Được kích hoạt khi có kết quả tìm kiếm mới cho một yêu cầu tìm đang hoạt động. Điều này có thể xảy ra nhiều lần cho một yêu cầu tìm khi hệ thống tìm thấy kết quả trùng khớp.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • searchText

      string

    • numberOfMatches

      số

    • activeMatchOrdinal

      số

    • selectionRect
    • đã huỷ

      boolean

    • finalUpdate

      string

loadabort

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

Được kích hoạt khi tải cấp cao nhất bị huỷ mà không thực hiện. Một thông báo lỗi sẽ được in trên bảng điều khiển trừ phi sự kiện đó được ngăn chặn theo mặc định.

Lưu ý: Khi tải tài nguyên bị huỷ, sự kiện loadabort cuối cùng sẽ được theo sau bởi một sự kiện loadstop, ngay cả khi tất cả lượt tải được cam kết kể từ sự kiện loadstop gần đây nhất (nếu có) đã bị huỷ.

Lưu ý: Khi việc tải URL giới thiệu hoặc URL JavaScript bị huỷ, loadabort sẽ được kích hoạt và sau đó, webview sẽ được điều hướng đến "about:blank".

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (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

      string

    • isTopLevel

      boolean

    • số

    • lý do

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

Được kích hoạt khi đã thực hiện tải. Điều này bao gồm việc điều hướng trong tài liệu hiện tại cũng như các lần tải ở cấp tài liệu khung phụ, nhưng không bao gồm các lần tải tài nguyên không đồng bộ.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • url

      string

    • isTopLevel

      boolean

loadredirect

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

Được kích hoạt khi yêu cầu tải cấp cao nhất chuyển hướng đến một URL khác.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • oldUrl

      string

    • newUrl

      string

    • isTopLevel

      boolean

loadstart

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

Được kích hoạt khi quá trình tải bắt đầu.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • url

      string

    • isTopLevel

      boolean

loadstop

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

Được kích hoạt khi tất cả lượt tải ở cấp khung hình trong một trang khách (bao gồm tất cả các khung phụ của trang đó) đã hoàn tất. Điều này bao gồm việc điều hướng trong tài liệu hiện tại cũng như các lần tải ở cấp tài liệu khung phụ, nhưng không bao gồm các lần tải tài nguyên không đồng bộ. Sự kiện này kích hoạt mỗi khi số lượt tải ở cấp tài liệu chuyển đổi từ 1 (hoặc nhiều) sang 0. Ví dụ: nếu một trang đã tải xong (tức là loadstop đã được kích hoạt một lần) tạo iframe mới tải trang, sau đó loadstop thứ hai sẽ kích hoạt khi tải trang iframe hoàn tất. Mẫu này thường thấy trên các trang tải quảng cáo.

Lưu ý: Khi một lượt tải cam kết bị huỷ, sự kiện loadstop sẽ diễn ra sau sự kiện loadabort, ngay cả khi tất cả lượt tải đã cam kết kể từ sự kiện loadstop gần đây nhất (nếu có) đã bị huỷ.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    () => void

newwindow

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

Được kích hoạt khi trang khách cố mở một cửa sổ trình duyệt mới.

Mã ví dụ sau đây sẽ tạo và điều hướng một webview mới trong trình nhúng cho mỗi cửa sổ mới được yêu cầu:

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (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

    • cửa sổ
    • targetUrl

      string

    • initialWidth

      số

    • initialHeight

      số

    • tên

      string

    • windowOpenDisposition

      "bỏ qua"
       | "save_to_disk"
       | "current_tab"
       | &quot;new_background_tab&quot;
       | "new_foreground_tab"
       | "new_window"
       | "new_ tạm thời"

permissionrequest

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

Được kích hoạt khi trang khách cần yêu cầu quyền đặc biệt từ người nhúng.

Mã ví dụ sau đây sẽ cấp quyền truy cập vào API webkitGetUserMedia cho trang khách. Xin lưu ý rằng ứng dụng sử dụng mã ví dụ này phải tự chỉ định các quyền audioCapture và/hoặc videoCapture trong tệp kê khai:

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • quyền

      "media"
       | "vị trí địa lý"
       | "pointerLock"
       | "tải xuống"
       | "loadplugin"
       | "hệ thống tệp"
       | "toàn màn hình"
       | "ẩn"

    • request

      đối tượng

responsive

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

Được kích hoạt khi quá trình hiển thị nội dung web khách đã trở lại phản hồi sau khi không phản hồi.

Mã ví dụ sau đây sẽ làm mờ hoặc mờ dần phần tử webview khi phần tử này trở nên thích ứng hoặc không phản hồi:

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (processID: number) => void

    • processID

      số

sizechanged

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

Được kích hoạt khi nội dung web được nhúng được đổi kích thước thông qua autosize. Chỉ kích hoạt nếu autosize được bật.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • oldWidth

      số

    • oldHeight

      số

    • newWidth

      số

    • newHeight

      số

unresponsive

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

Được kích hoạt khi quá trình kết xuất nội dung web khách không phản hồi. Sự kiện này sẽ được tạo một lần bằng một sự kiện thích ứng phù hợp nếu khách bắt đầu trả lời lại.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (processID: number) => void

    • processID

      số

zoomchange

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

Được kích hoạt khi mức thu phóng của trang thay đổi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

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

    • oldZoomFactor

      số

    • newZoomFactor

      số