chrome.types

refresh date: 2026-09-25 robots: noindex

Mô tả

chrome.types API chứa các nội dung khai báo loại cho Chrome.

Cài đặt Chrome

Nguyên mẫu ChromeSetting cung cấp một tập hợp các hàm phổ biến (get(), set() và clear()) cũng như một trình xuất bản sự kiện (onChange) cho các chế độ cài đặt của trình duyệt Chrome. Ví dụ về chế độ cài đặt proxy minh hoạ cách sử dụng các hàm này.

Phạm vi và vòng đời

Chrome phân biệt giữa ba phạm vi khác nhau của chế độ cài đặt trình duyệt:

regular

Các chế độ cài đặt được đặt trong phạm vi regular sẽ áp dụng cho các cửa sổ trình duyệt thông thường và được các cửa sổ ẩn danh kế thừa nếu không bị ghi đè. Các chế độ cài đặt này được lưu trữ vào ổ đĩa và giữ nguyên cho đến khi bị tiện ích quản lý xoá, hoặc tiện ích quản lý bị tắt hoặc gỡ cài đặt.

incognito_persistent

Chế độ cài đặt được đặt trong phạm vi incognito_persistent chỉ áp dụng cho cửa sổ ẩn danh. Đối với các chế độ cài đặt này, chúng sẽ ghi đè chế độ cài đặt regular. Các chế độ cài đặt này được lưu trữ vào ổ đĩa và giữ nguyên cho đến khi bị tiện ích quản lý xoá, hoặc tiện ích quản lý bị tắt hoặc gỡ cài đặt.

incognito_session_only

Chế độ cài đặt được đặt trong phạm vi incognito_session_only chỉ áp dụng cho cửa sổ ẩn danh. Đối với các chế độ cài đặt này, chúng sẽ ghi đè chế độ cài đặt regular và incognito_persistent. Các chế độ cài đặt này không được lưu trữ vào ổ đĩa và sẽ bị xoá khi bạn đóng cửa sổ ẩn danh cuối cùng. Bạn chỉ có thể đặt các chế độ này khi có ít nhất một cửa sổ ẩn danh đang mở.

Quyền ưu tiên

Chrome quản lý các chế độ cài đặt ở nhiều lớp. Danh sách sau đây mô tả các lớp có thể ảnh hưởng đến chế độ cài đặt có hiệu lực, theo thứ tự ưu tiên tăng dần.

1. Chế độ cài đặt hệ thống do hệ điều hành cung cấp
2. Tham số dòng lệnh
3. Chế độ cài đặt do tiện ích cung cấp
4. Chính sách

Như danh sách này cho thấy, các chính sách có thể thay thế mọi thay đổi mà bạn chỉ định cho tiện ích của mình. Bạn có thể sử dụng hàm get() để xác định xem tiện ích của bạn có khả năng cung cấp một chế độ cài đặt hay chế độ cài đặt này sẽ bị ghi đè hay không.

Như đã thảo luận ở trên, Chrome cho phép sử dụng các chế độ cài đặt khác nhau cho cửa sổ thông thường và cửa sổ ẩn danh. Ví dụ sau đây minh hoạ hành vi này. Giả sử không có chính sách nào ghi đè chế độ cài đặt và một tiện ích có thể đặt chế độ cài đặt cho cửa sổ thông thường (R) và chế độ cài đặt cho cửa sổ ẩn danh (I).

• Nếu bạn chỉ đặt (R), thì các chế độ cài đặt này sẽ có hiệu lực cho cả cửa sổ thông thường và cửa sổ ẩn danh.
• Nếu bạn chỉ đặt (I), thì các chế độ cài đặt này chỉ có hiệu lực đối với cửa sổ ẩn danh. Cửa sổ thông thường sử dụng các chế độ cài đặt do các lớp thấp hơn xác định (tuỳ chọn dòng lệnh và chế độ cài đặt hệ thống).
• Nếu bạn đặt cả (R) và (I), thì các chế độ cài đặt tương ứng sẽ được dùng cho cửa sổ thông thường và cửa sổ ẩn danh.

Nếu hai hoặc nhiều tiện ích muốn đặt cùng một chế độ cài đặt thành các giá trị khác nhau, thì tiện ích được cài đặt gần đây nhất sẽ được ưu tiên hơn các tiện ích khác. Nếu tiện ích được cài đặt gần đây nhất chỉ đặt (I), thì các chế độ cài đặt của cửa sổ thông thường có thể do các tiện ích đã cài đặt trước đó xác định.

Giá trị có hiệu lực của một chế độ cài đặt là giá trị có được sau khi xem xét các quy tắc ưu tiên. Chrome sử dụng tệp này.

Loại

ChromeSetting

Một giao diện cho phép truy cập vào các chế độ cài đặt của trình duyệt Chrome. Hãy xem accessibilityFeatures để biết ví dụ.

Thuộc tính

• onChange

  Event<functionvoidvoid>

  Được kích hoạt sau khi chế độ cài đặt thay đổi.

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

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

  • callback

    hàm

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

    (details: object) => void

    • chi tiết

      đối tượng

      • incognitoSpecific

        boolean không bắt buộc

        Liệu giá trị đã thay đổi có dành riêng cho phiên truy cập ẩn danh hay không. Thuộc tính này sẽ chỉ xuất hiện nếu người dùng đã bật tiện ích ở chế độ ẩn danh.

      • levelOfControl

        LevelOfControl

        Cấp độ kiểm soát của chế độ cài đặt.

      • value

        T

        Giá trị của chế độ cài đặt sau khi thay đổi.

• xoá

  void

  Promise

  Xoá chế độ cài đặt, khôi phục mọi giá trị mặc định.

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

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

  • chi tiết

    đối tượng

    Chế độ cài đặt cần xoá.

    • phạm vi

      ChromeSettingScope không bắt buộc

      Nơi xoá chế độ cài đặt (mặc định: thông thường).

  • callback

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

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

    () => void

  • returns

    Promise<void>

    Chrome 96 trở lên

    Được gọi khi hoàn tất thao tác xoá.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

• get

  void

  Promise

  Lấy giá trị của một chế độ cài đặt.

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

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

  • chi tiết

    đối tượng

    Chế độ cài đặt cần xem xét.

    • ẩn danh

      boolean không bắt buộc

      Có trả về giá trị áp dụng cho phiên truy cập ẩn danh hay không (mặc định là false).

  • callback

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

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

    (details: object) => void

    • chi tiết

      đối tượng

      Thông tin chi tiết về giá trị hiện có hiệu lực.

      • incognitoSpecific

        boolean không bắt buộc

        Liệu giá trị có hiệu lực có dành riêng cho phiên truy cập ẩn danh hay không. Thuộc tính này sẽ chỉ xuất hiện nếu thuộc tính incognito trong tham số details của get() là đúng.

      • levelOfControl

        LevelOfControl

        Cấp độ kiểm soát của chế độ cài đặt.

      • value

        T

        Giá trị của chế độ cài đặt.

  • returns

    <object> hứa hẹn

    Chrome 96 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

• đặt

  void

  Promise

  Đặt giá trị của một chế độ cài đặt.

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

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

  • chi tiết

    đối tượng

    Chế độ cài đặt cần thay đổi.

    • phạm vi

      ChromeSettingScope không bắt buộc

      Nơi đặt chế độ cài đặt (mặc định: thông thường).

    • value

      T

      Giá trị của chế độ cài đặt. Xin lưu ý rằng mỗi chế độ cài đặt đều có một loại giá trị cụ thể, được mô tả cùng với chế độ cài đặt đó. Tiện ích không được đặt giá trị thuộc loại khác.

  • callback

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

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

    () => void

  • returns

    Promise<void>

    Chrome 96 trở lên

    Được gọi khi hoàn tất thao tác đặt.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

ChromeSettingScope

Chrome 44 trở lên

Phạm vi của ChromeSetting. Một trong số

• regular: chế độ cài đặt cho hồ sơ thông thường (được hồ sơ ẩn danh kế thừa nếu không bị ghi đè ở nơi khác),
• regular\_only: chế độ cài đặt chỉ dành cho hồ sơ thông thường (không được hồ sơ ẩn danh kế thừa),
• incognito\_persistent: chế độ cài đặt cho hồ sơ ẩn danh vẫn được giữ nguyên sau khi khởi động lại trình duyệt (ghi đè các lựa chọn ưu tiên thông thường),
• incognito\_session\_only: chế độ cài đặt cho hồ sơ ẩn danh chỉ có thể được đặt trong phiên truy cập ẩn danh và sẽ bị xoá khi phiên truy cập ẩn danh kết thúc (ghi đè các lựa chọn ưu tiên thông thường và incognito_persistent).

Enum

"regular"

"regular_only"

"incognito_persistent"

"incognito_session_only"

LevelOfControl

Chrome 44 trở lên

Một trong số

• not\_controllable: không thể được kiểm soát bởi bất kỳ tiện ích nào
• controlled\_by\_other\_extensions: do các tiện ích có mức độ ưu tiên cao hơn kiểm soát
• controllable\_by\_this\_extension: có thể được kiểm soát bằng tiện ích này
• controlled\_by\_this\_extension: do tiện ích này kiểm soát

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"