WindowSharedStorage: phương thức run()
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Phương thức run() của giao diện WindowSharedStorage thực thi một thao tác run đã được đăng ký trong module được thêm vào SharedStorageWorklet của nguồn gốc hiện tại.
Note: Run output gate nhằm mục đích là một cách chung để xử lý một số dữ liệu bộ nhớ dùng chung.
Cú pháp
run(name)
run(name, options)
Tham số
name-
Một chuỗi đại diện cho tên của thao tác đã đăng ký trong module worklet bộ nhớ dùng chung. Phải khớp với tên được cung cấp cho thao tác khi nó được đăng ký với
SharedStorageWorkletGlobalScope.register(). optionsOptional-
Một đối tượng tùy chọn có thể chứa các thuộc tính sau:
dataOptional-
Một đối tượng đại diện cho bất kỳ dữ liệu nào cần thiết để thực thi thao tác.
keepAliveOptional-
Một giá trị boolean. Nếu đặt thành
true,SharedStorageWorkletGlobalScopecủa worklet liên quan được giữ sống và thao tác có thể chạy lại. Mặc định làfalse, nghĩa làSharedStorageWorkletGlobalScopebị kết thúc sau khi thao tác chạy và không thể chạy lại.
Giá trị trả về
Một Promise hoàn thành với undefined.
Ngoại lệ
TypeError-
Được ném nếu:
- Module worklet chưa được thêm bằng
addModule(). - Bộ nhớ dùng chung bị vô hiệu hóa (ví dụ: thông qua cài đặt trình duyệt).
- Trang web gọi không có Shared Storage API được đưa vào trong quá trình đăng ký privacy sandbox thành công.
- Module worklet chưa được thêm bằng
Ví dụ
async function measureUniqueReach() {
// Load the Shared Storage worklet
await window.sharedStorage.worklet.addModule("reach-measurement-worklet.js");
// Run the reach measurement operation
await window.sharedStorage.run("reach-measurement", {
data: { contentId: "1234" },
});
}
measureUniqueReach();
Xem Unique reach measurement để được giải thích đầy đủ về ví dụ này. Xem Shared Storage API để biết thêm ví dụ.