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 giao diện của webview và tương tác với nội dung web, bắt đầu thao tác điều hướng trong một trang web được nhúng, phản ứng với các sự kiện lỗi xảy ra trong trang web đó và làm nhiều việc khác (xem phần Sử dụng).

Quyền

webview

Loại

ClearDataOptions

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

Thuộc tính

  • từ

    số không bắt buộc

    Xoá dữ liệu tích luỹ từ ngày này trở đi, được biểu thị bằng mili giây kể từ thời gian bắt đầu (có thể truy cập thông qua phương thức getTime của đối tượng Date JavaScript). Nếu không có, giá trị mặc định 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 diễn giải là false.

Thuộc tính

  • appcache

    boolean không bắt buộc

    Bộ nhớ đệm ứng dụng của trang web.

  • 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; không giới hạn ở phạm vi 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

    Hệ thống tệp của trang web.

  • indexedDB

    boolean không bắt buộc

    Dữ liệu IndexedDB của trang web.

  • localStorage

    boolean không bắt buộc

    Dữ liệu trong bộ nhớ cục bộ của trang web.

  • 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

    Dữ liệu WebSQL của trang web.

ContentScriptDetails

Chrome 44 trở lên

Thông tin chi tiết về tập lệnh nội dung cần chèn. Hãy tham khảo tài liệu về tập lệnh nội dung để biết thêm thông tin chi tiết.

Thuộc tính

  • all_frames

    boolean không bắt buộc

    Nếu all_frames là true, thì điều này có nghĩa là JavaScript hoặc CSS phải được chèn vào tất cả các khung của trang hiện tại. Theo mặc định, all_frames là false 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 tệp CSS cần chèn vào các trang trùng khớp. Các phần tử này được chèn theo thứ tự xuất hiện, trước khi bất kỳ DOM nào được tạo hoặc hiển thị cho trang.

  • exclude_globs

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

    Được áp dụng sau khi khớp để loại trừ các URL khớp với biểu thức chính quy này. Dùng để mô phỏng từ khoá Greasemonkey @exclude.

  • exclude_matches

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

    Loại trừ 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 khi so khớp để chỉ bao gồm những URL cũng khớp với glob này. Dùng để mô phỏng từ khoá @include Greasemonkey.

  • js

    InjectionItems không bắt buộc

    Mã JavaScript hoặc danh sách tệp JavaScript cần chèn vào các trang trùng khớp. Các thành phầ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 trên about:blank và about:srcdoc hay không. Tập lệnh nội dung sẽ chỉ được chèn trên 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 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 các khung hộp cát.

  • khớp với

    string[]

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

  • tên

    chuỗi

    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

Tên người dùng để nhắn tin đến một 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 đang hiển thị một trang từ nguồn gốc mục tiêu. 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.

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

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

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

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

    • tin nhắn

      bất kỳ

      Đối tượng thông báo để gửi cho khách.

    • targetOrigin

      chuỗi

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

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 chọn: true (đã chọn) và false (chưa chọn). Mỗi lần chỉ có thể chọn một mục trong một nhóm mục chọn.

  • ngữ cảnh

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

    Danh sách ngữ cảnh mà mục trình đơn này sẽ xuất hiện. 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 hạn chế mục chỉ áp dụng cho những tài liệu có URL khớp với một trong các mẫu đã cho. (Đ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 phần Mẫu so khớp.

  • đang bật

    boolean không bắt buộc

    Liệu mục trình đơn theo bối cảnh này có được 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 để chỉ định cho mục này. Bắt buộc đối với trang sự kiện. Không được trùng với mã nhận dạng khác của tiện ích này.

  • parentId

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

    Mã của một mục trình đơn mẹ; điều này khiến mục này trở thành mục con của một 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ẻ neo.

  • tiêu đề

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

    Văn bản sẽ hiển thị trong mục; đây là thông tin bắt buộc trừ phi type là "dấu phân cách". Khi ngữ cảnh là "selection" (lựa chọn), bạn có thể sử dụng %s trong chuỗi để hiển thị văn bản đã chọn. Ví dụ: nếu giá trị của thông số này là "Dịch "%s" sang tiếng La Tinh" và người dùng chọn từ "cool", thì mục trình đơn theo bối cảnh cho lựa chọn này sẽ là "Dịch "cool" sang tiếng La Tinh".

  • loại

    ItemType không bắt buộc

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

  • onclick

    void không bắt buộc

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

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

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

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

ContextMenus

Chrome 44 trở lên

Thuộc tính

  • onShow

    Event<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. 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) => {...}

    • lệnh gọi lại

      hàm

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

      (event: object) => void

      • event

        đối tượng

        • preventDefault

          void

          Gọi phương thức 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 trình đơn theo ngữ cảnh mới. Xin lưu ý rằng nếu xảy ra lỗi trong quá trình tạo, bạn có thể không phát hiện ra cho đến khi lệnh gọi lại tạo được 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

    • lệnh gọi lại

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

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

      () => void

    • returns

      chuỗi | số

      Mã của mặt hàng 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

      chuỗi | số

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

    • lệnh gọi lại

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

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

      () => void

  • removeAll

    void

    Xoá tất cả các mục 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) => {...}

    • lệnh gọi lại

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

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

      () => void

  • cập nhật

    void

    Cập nhật một mục 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

      chuỗi | 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 như hàm tạo.

    • lệnh gọi lại

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

      Tham số callback 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 chọn: true (đã chọn) và false (chưa chọn). Mỗi lần chỉ có thể chọn một mục trong một nhóm mục chọn.

  • ngữ cảnh

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

    Danh sách ngữ cảnh mà mục trình đơn này sẽ xuất hiện.

  • documentUrlPatterns

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

    Cho phép bạn hạn chế mục chỉ áp dụng cho những tài liệu có URL khớp với một trong các mẫu đã cho. (Đ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 phần Mẫu khớp.

  • đang bật

    boolean không bắt buộc

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

  • parentId

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

    Mã của một mục trình đơn mẹ; điều này khiến mục này trở thành mục con của một mục đã thêm trước đó. Lưu ý: Bạn không thể thay đổi một mục thành phần 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ẻ neo.

  • tiêu đề

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

    Văn bản sẽ hiển thị trong mục

  • loại

    ItemType không bắt buộc

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

  • onclick

    void không bắt buộc

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

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

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

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

ContextType

Chrome 44 trở lên

Các bối cảnh khác nhau mà trình đơn có thể xuất hiện. Việc chỉ định "tất cả" tương đương với việc kết hợp tất cả ngữ cảnh khác.

Enum

"tất cả"

"page"

"khung"

"selection"

"đường liên kết"

"editable"

"image"

"video"

"audio"

DialogController

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

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 để 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

    chuỗi

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

  • url

    chuỗi

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

  • allow

    void

    Cho phép yêu cầu cấp 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 bạn 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

    chuỗi

    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 cấp 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 kiếm.

Thuộc tính

  • activeMatchOrdinal

    số

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

  • đã huỷ

    boolean

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

  • numberOfMatches

    số

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

  • selectionRect

    SelectionRect

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

FindOptions

Các tuỳ chọn cho yêu cầu tìm kiếm.

Thuộc tính

  • lui

    boolean không bắt buộc

    Cờ để tìm 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

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

FullscreenPermissionRequest

Chrome 43 trở lên

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

Thuộc tính

  • nguồn gốc

    chuỗi

    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 cấp 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

    chuỗi

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

  • allow

    void

    Cho phép yêu cầu cấp 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 bạn 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

    chuỗi

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

  • allow

    void

    Cho phép yêu cầu cấp 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 bạn 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 cùng lúc.

Thuộc tính

  • mã

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

    Mã JavaScript hoặc CSS để chèn.

    Cảnh báo: Hãy cẩn thận khi sử dụng tham số code. Việc sử dụng không đúng cách có thể khiến ứng dụng của bạn bị tấn công tập lệnh trên nhiều trang web.

  • tệp

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

    Tệp JavaScript hoặc CSS để 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

  • mã

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

    Mã JavaScript hoặc CSS sẽ được chèn vào các trang trùng khớp.

  • tệp

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

    Danh sách các tệp JavaScript hoặc CSS cần chèn vào các trang trùng khớp. Các giá trị 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

    chuỗi

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

  • tên

    chuỗi

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

  • allow

    void

    Cho phép yêu cầu cấp quyền. Đây là hành vi mặc định nếu bạn 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

    chuỗi

    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 cấp 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 bạn không gọi allow.

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

    () => {...}

NewWindow

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

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) => {...}

    • webview

      đối tượng

      Phần tử webview mà trang đích sẽ được đính kèm.

  • hủy

    void

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

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

    () => {...}

PointerLockPermissionRequest

Loại đối tượng 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 giữ khoá con trỏ hay không.

  • url

    chuỗi

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

  • userGesture

    boolean

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

  • allow

    void

    Cho phép yêu cầu cấp 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 bạn không gọi allow.

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

    () => {...}

SelectionRect

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

Ngữ nghĩa chứa 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ùng của màn hình đến cạnh trên cùng 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 cung cấp quyền truy cập vào các sự kiện webRequest trên trang khách. Hãy 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 liên quan. Lưu ý: Sự kiện chrome.webRequest.onActionIgnored không được hỗ trợ cho thành phần hiển thị web.

Để minh hoạ sự khác biệt về cách sử dụng so với API webRequest của tiện ích, hãy xem xét mã ví dụ sau đây chặn mọi yêu cầu của khách truy cập đố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 onRequest và onMessage. 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 webview khai báo phải được tạo bản sao từ các đối tác chrome.webViewRequest.* tương ứng. Mã ví dụ sau đây sẽ chặn tất cả các yêu cầu đến "example.com" trên webview myWebview theo cách khai báo:

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ý tính năng thu phóng trong webview.

Enum

"trên mỗi nguồn gốc"
Các thay đổi về tỷ lệ thu phóng sẽ vẫn tồn tại trong nguồn gốc của trang được thu phóng, tức là tất cả các thành phần hiển thị web khác trong cùng một phân vùng được điều hướng đến cùng một nguồn gốc đó cũng sẽ được thu phóng. Hơn nữa, các thay đổi về tỷ lệ thu phóng per-origin được lưu cùng với nguồn gốc, nghĩa là khi điều hướng đến các trang khác trong cùng một nguồn gốc, tất cả các trang đó sẽ được thu phóng theo cùng một tỷ lệ thu phóng.

"trên mỗi chế độ xem"
Các thay đổi về chế độ thu phóng chỉ có hiệu lực trong thành phần hiển thị web này và các thay đổi về chế độ thu phóng trong các thành phần hiển thị web khác sẽ không ảnh hưởng đến chế độ thu phóng của thành phần hiển thị web này. Ngoài ra, các thay đổi về mức thu phóng per-view sẽ được đặt lại khi điều hướng; việc điều hướng một thành phần hiển thị web sẽ luôn tải các trang có hệ số thu phóng theo 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 webview. Nội dung sẽ trở về mức thu phóng mặc định và mọi thay đổi về mức thu phóng sẽ bị bỏ qua.

Thuộc tính

contentWindow

Tham chiếu đối tượng có thể dùng để đăng tin nhắn vào trang khách.

Loại

ContentWindow

contextMenus

Chrome 44 trở lên

Tương tự như ContextMenus API của Chrome, nhưng áp dụng cho webview thay vì trình duyệt. Sử dụng API webview.contextMenus để thêm các 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à các mục bổ sung trong trình đơn theo bối cảnh áp dụng, chẳng hạn như hình ảnh, đường liên kết siêu và trang.

Loại

ContextMenus

request

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

Loại

WebRequestEventInterface

Phương thức

addContentScripts()

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

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

Ví dụ sau đây 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 tập lệnh.

Ví dụ sau đây cho thấy cách ghi đè một 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 đợi thao tác điều hướng tiếp theo để chèn các tập lệnh. Nếu bạn muốn chèn ngay lập tức, executeScript sẽ là lựa chọn phù hợp.

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

Hãy tham khảo tài liệu về tập lệnh nội dung để biết thêm thông tin chi tiết.

Tham số

back()

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

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

Tham số

  • lệnh gọi lại

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

    Chrome 44 trở lên

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

    (success: boolean) => void

    • thành công

      boolean

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

canGoBack()

chrome.webviewTag.canGoBack()

Cho biết liệu có thể quay lại 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 liệu có thể di chuyển về phía trước 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

captureVisibleRegion()

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

Ghi lại vùng hiển thị của thành phần hiển thị web.

Tham số

  • tùy chọn

    ImageDetails không bắt buộc

  • lệnh gọi lại

    hàm

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

    (dataUrl: string) => void

    • dataUrl

      chuỗi

      URL dữ liệu mã hoá hình ảnh của khu vực hiển thị của thẻ đã chụp. Có thể được gán cho thuộc tính "src" 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

    ClearDataOptions

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

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

  • lệnh gọi lại

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

    Tham số callback 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 sử 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

    InjectDetails

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

  • lệnh gọi lại

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

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

    (result?: any[]) => void

    • kết quả

      any[] 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,
)

Bắt đầu một yêu cầu tìm kiếm trong trang.

Tham số

  • searchText

    chuỗi

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

  • tùy chọn

    FindOptions không bắt buộc

    Các tuỳ chọn cho yêu cầu tìm kiếm.

  • lệnh gọi lại

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

    Tham số callback 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 kiếm. Bạn có thể bỏ qua results nếu không sử dụng 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 để phân biệt thời điểm yêu cầu tìm kiếm hoàn tất.

forward()

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

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

Tham số

  • lệnh gọi lại

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

    Chrome 44 trở lên

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

    (success: boolean) => void

    • thành công

      boolean

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

getAudioState()

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

Truy vấn trạng thái âm thanh.

Tham số

  • lệnh gọi lại

    hàm

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

    (audible: boolean) => void

    • audible

      boolean

getProcessId()

chrome.webviewTag.getProcessId()

Trả về mã nhận dạng 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 trình nhúng biết số lượng khách sẽ bị ảnh hưởng khi chấm dứt quy trình. Hai khách 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ột mã phân vùng bộ nhớ. Lệnh gọi này là đồng bộ và trả về khái niệm được lưu vào bộ nhớ đệm của trình nhúng về mã nhận dạng quy trình hiện tại. Mã quy trình không giống với mã quy 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 trang khách.

Giá trị trả về

  • chuỗi

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)

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

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback 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,
)

Lấy chế độ thu phóng hiện tại.

Tham số

  • lệnh gọi lại

    hàm

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

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      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 trong nhật ký bằng cách sử dụng chỉ mục nhật ký tương ứng với thao tác điều hướng hiện tại. Nếu không thể điều hướng theo yêu cầu, 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 sẽ được điều hướng đến. Ví dụ: giá trị 2 sẽ di chuyển tới 2 mục trong nhật ký nếu có thể; giá trị -3 sẽ di chuyển lui 3 mục.

  • lệnh gọi lại

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

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

    (success: boolean) => void

    • thành công

      boolean

      Cho biết liệu thao tác đ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

    InjectDetails

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

  • lệnh gọi lại

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

    Tham số callback 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 hay không.

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback 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 tính năng điều hướng không gian có được bật cho webview hay không.

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback 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 URL dữ liệu có URL cơ sở được chỉ định dùng cho các đường liên kết tương đối. Bạn có thể cung cấp một URL ảo để hiển thị cho người dùng thay vì URL dữ liệu.

Tham số

  • dataUrl

    chuỗi

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

  • baseUrl

    chuỗi

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

  • virtualUrl

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

    URL sẽ hiển thị cho người dùng (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 từ 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 xoá "myRule" đã 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, tất cả tập lệnh nội dung được thêm vào webview sẽ bị xoá.

setAudioMuted()

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

Đặt trạng thái tắt tiếng âm thanh của webview.

Tham số

  • tắt tiếng

    boolean

    Giá trị âm thanh tắt

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 webview.

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 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à tính năng ghi đè này được áp dụng.

Tham số

  • userAgent

    chuỗi

    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à tính chất ổn định của thay đổi này được xác định theo chế độ thu phóng hiện tại của webview (xem webviewTag.ZoomMode).

Tham số

  • zoomFactor

    số

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

  • lệnh gọi lại

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

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

    () => void

setZoomMode()

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

Đặt chế độ thu phóng của webview.

Tham số

  • ZoomMode

    ZoomMode

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

  • lệnh gọi lại

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

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

    () => void

stop()

chrome.webviewTag.stop()

Dừng tải thành phần điều hướng webview hiện tại nếu đang tải.

stopFinding()

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

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

Tham số

  • hành động

    "clear"
     | "keep"
     | "activate"
     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 hoạt động sau khi phiên tìm kiếm kết thúc. clear sẽ xoá phần đánh dấu trên kết quả trùng khớp đang hoạt động; keep sẽ giữ nguyên phần đánh dấu trên kết quả trùng khớp đang hoạt động; activate sẽ giữ nguyên phần đánh dấu trên kết quả trùng khớp đang hoạt động và mô phỏng một lượt 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 chấm dứt quy trình kết xuất của trang web khách. Điều 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ẻ này dùng chung một quy trình, nhưng sẽ không ảnh hưởng đến 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 sẽ chuyển webview đến about:blank khi khách cố gắng tự đóng.

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

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback 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 của bảng điều khiển.

Mã ví dụ sau chuyển tiếp tất cả thông điệp nhật ký đến bảng điều khiển của trình 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ố

  • lệnh gọi lại

    hàm

    Tham số callback 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

      chuỗi

    • dòng

      số

    • sourceId

      chuỗi

contentload

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

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

Đoạn 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 trang tải:

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

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback 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ở một hộp thoại phương thức thông 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 mỗi 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ố

  • lệnh gọi lại

    hàm

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

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

    • messageType

      "alert"
       | "confirm"
       | "prompt"

    • messageText

      chuỗi

    • hộp thoại

      DialogController

exit

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

Được kích hoạt khi quá trình hiển thị nội dung web của khách đã thoát.

Mã ví dụ sau đây sẽ hiển thị một thông báo tạm biệt mỗi khi 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ố

  • lệnh gọi lại

    hàm

    Tham số callback 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 kiếm đang hoạt động. Điều này có thể xảy ra nhiều lần đối với một yêu cầu tìm kiếm khi tìm thấy kết quả trùng khớp.

Tham số

  • lệnh gọi lại

    hàm

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

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

    • searchText

      chuỗi

    • numberOfMatches

      số

    • activeMatchOrdinal

      số

    • selectionRect

      SelectionRect

    • đã huỷ

      boolean

    • finalUpdate

      chuỗi

loadabort

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

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

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

Lưu ý: Khi quá trình tải URL về thông tin hoặc URL JavaScript bị huỷ, loadabort sẽ được kích hoạt, sau đó webview sẽ được chuyển đến "about:blank".

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback 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

      chuỗi

    • isTopLevel

      boolean

    • mã

      số

    • lý do

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

Được kích hoạt khi một tải đã được thực hiện. Đ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ư tải cấp tài liệu khung con, nhưng không bao gồm việc tải tài nguyên không đồng bộ.

Tham số

  • lệnh gọi lại

    hàm

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

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

    • url

      chuỗi

    • isTopLevel

      boolean

loadredirect

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

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

Tham số

  • lệnh gọi lại

    hàm

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

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

    • oldUrl

      chuỗi

    • newUrl

      chuỗi

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

  • lệnh gọi lại

    hàm

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

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

    • url

      chuỗi

    • isTopLevel

      boolean

loadstop

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

Được kích hoạt khi tất cả các lượt tải ở cấp khung trong trang khách (bao gồm cả tất cả các khung con) đã 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ư tải cấp tài liệu khung con, nhưng không bao gồm việc 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ừ một (hoặc nhiều) thành 0. Ví dụ: nếu một trang đã tải xong (tức là loadstop đã kích hoạt một lần) tạo một iframe mới để tải một trang, sau đó loadstop thứ hai sẽ kích hoạt khi quá trình tải trang iframe hoàn tất. Mẫu này thường được quan sát 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 cuối cùng sẽ tuân theo sự kiện loadabort, ngay cả khi tất cả các lượt tải đã cam kết kể từ sự kiện loadstop cuối cùng (nếu có) đều bị huỷ.

Tham số

  • lệnh gọi lại

    hàm

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

    () => void

newwindow

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

Được kích hoạt khi trang khách cố gắng 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ố

  • lệnh gọi lại

    hàm

    Tham số callback 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ổ

      NewWindow

    • targetUrl

      chuỗi

    • initialWidth

      số

    • initialHeight

      số

    • tên

      chuỗi

    • windowOpenDisposition

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

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ừ trình nhúng.

Mã ví dụ sau đây sẽ cấp cho trang khách quyền truy cập vào API webkitGetUserMedia. 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 tệp kê khai audioCapture và/hoặc videoCapture:

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

Tham số

  • lệnh gọi lại

    hàm

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

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

    • quyền

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

    • 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 của khách đã phản hồi lại sau khi không phản hồi.

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

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

Tham số

  • lệnh gọi lại

    hàm

    Tham số callback 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ố

  • lệnh gọi lại

    hàm

    Tham số callback 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 hiển thị nội dung web của khách không phản hồi. Sự kiện này sẽ được tạo một lần với 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ố

  • lệnh gọi lại

    hàm

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

    (processID: number) => void

    • processID

      số

zoomchange

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

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

Tham số

  • lệnh gọi lại

    hàm

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

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

    • oldZoomFactor

      số

    • newZoomFactor

      số