Skip to main content

WebStorage

WebStorage 通过异步、浏览器一致的 API 为当前源公开页面的 localStorage 或 sessionStorage。

🌐 WebStorage exposes the page's localStorage or sessionStorage for the current origin via an async, browser-consistent API.

实例可以通过 page.localStorage 和 page.sessionStorage 访问。

🌐 Instances are accessed through page.localStorage and page.sessionStorage.

await page.goto('https://example.com');
await page.localStorage.setItem('token', 'abc');
const token = await page.localStorage.getItem('token');
const all = await page.localStorage.items();
await page.localStorage.removeItem('token');
await page.localStorage.clear();

方法​

🌐 Methods

clear​

Added in: v1.61 webStorage.clear

从存储中移除所有物品。

🌐 Removes all items from the storage.

用法

await webStorage.clear();

返回

getItem​

Added in: v1.61 webStorage.getItem

如果存在，返回给定name的值。

🌐 Returns the value for the given name if present.

用法

await webStorage.getItem(name);

参数

  • name string#

    要检索的项目名称。

返回

items​

Added in: v1.61 webStorage.items

以名称/值对的形式返回存储中的所有项目。

🌐 Returns all items in the storage as name/value pairs.

用法

await webStorage.items();

返回

removeItem​

Added in: v1.61 webStorage.removeItem

移除具有给定name的项目。如果项目不存在，则不执行任何操作。

🌐 Removes the item with the given name. No-op if the item is absent.

用法

await webStorage.removeItem(name);

参数

  • name string#

    要移除的物品名称。

返回

setItem​

Added in: v1.61 webStorage.setItem

为指定的 name 设置值。会覆盖该名称的任何现有值。

🌐 Sets the value for the given name. Overwrites any existing value for that name.

用法

await webStorage.setItem(name, value);

参数

  • name string#

    要设置的项目名称。

  • value string#

    该项目的新值。

返回