文件：requestStorageAccessFor() 方法

語法

requestStorageAccessFor(requestedOrigin)

引數

requestedOrigin

一個字串，表示你請求第三方 Cookie 訪問許可權的來源 URL。

返回值

一個 Promise，如果第三方 Cookie 訪問許可權被授予則以 undefined 履行，如果訪問許可權被拒絕則拒絕。

除非頂級內容當前正在處理使用者手勢（例如點選或輕觸）（瞬時啟用），或者之前已授予許可權，否則 requestStorageAccessFor() 請求將自動被拒絕。如果之前未授予許可權，則它們必須在基於使用者手勢的事件處理程式中執行。使用者手勢行為取決於 Promise 的狀態

• 如果 Promise 解析（即，許可權已授予），則使用者手勢未被消耗，因此指令碼可以隨後呼叫需要使用者手勢的 API。
• 如果 Promise 被拒絕（即，許可權未授予），則使用者手勢已被消耗，因此指令碼不能執行任何需要手勢的操作。這可以防止指令碼在許可權被拒絕時再次呼叫 requestStorageAccessFor()。

異常

InvalidStateError DOMException

如果當前的 Document 尚未啟用，則丟擲此錯誤。

NotAllowedError DOMException

在以下情況下丟擲

• 文件的視窗不是安全上下文。
• 文件不是頂級文件。
• 文件的源為 null。
• 提供的 requestedOrigin 是不透明的。
• 頂級站點和嵌入式站點不在同一相關網站集中。
• 嵌入的