diff --git a/files/zh-cn/web/api/storage/removeitem/index.html b/files/zh-cn/web/api/storage/removeitem/index.html index 0f1ff8c4653d43..3f1874ece13722 100644 --- a/files/zh-cn/web/api/storage/removeitem/index.html +++ b/files/zh-cn/web/api/storage/removeitem/index.html @@ -5,7 +5,7 @@ ---

{{APIRef("Web Storage API")}}

-

{{domxref("Storage")}} 接口的 removeItem() 方法,接受一个键名作为参数,会从给定的Storage对象中删除该键名(如果存在)。 如果没有与该给定键名匹配的项,则此方法将不执行任何操作。

+

{{domxref("Storage")}} 接口的 removeItem() 方法,接受一个键名作为参数,会从给定的 Storage 对象中删除该键名(如果存在)。 如果没有与该给定键名匹配的项,则此方法将不执行任何操作。

语法

diff --git a/files/zh-cn/web/api/storage_api/index.html b/files/zh-cn/web/api/storage_api/index.html index 306c6240e8c74c..28a426886841c3 100644 --- a/files/zh-cn/web/api/storage_api/index.html +++ b/files/zh-cn/web/api/storage_api/index.html @@ -32,7 +32,7 @@

站点存储单元

-

由存储标准描述并使用存储API进行交互的站点存储系统,由每个 {{Glossary("origin")}} 的单个站点存储单元site storage unit)组成。实际上,每个Web站点或Web应用程序都有自己的存储单元,用于存储数据。下图显示了一个站点存储池,其中包含三个存储单元,显示了存储单元如何可以在其中存储不同的数据类型,并且可能具有不同的配额(最大存储限制)。

+

由存储标准描述并使用存储 API 进行交互的站点存储系统,由每个 {{Glossary("origin")}} 的单个站点存储单元site storage unit)组成。实际上,每个 Web 站点或 Web 应用程序都有自己的存储单元,用于存储数据。下图显示了一个站点存储池,其中包含三个存储单元,显示了存储单元如何可以在其中存储不同的数据类型,并且可能具有不同的配额(最大存储限制)。

A diagram showing how the site storage pool consists of multiple storage units that contain data from various APIs as well as possible unused space left before the quota is reached.

@@ -59,13 +59,13 @@

存储模式

数据持久性与清理

-

如果站点或应用程序具有 “永久存储(persistent-storage” 功能权限,则可以使用 {{domxref("StorageManager.persist()")}} 方法来请求将其 box 设为持久的。由于使用特性或其他度量,用户代理还可以决定使站点的存储单元持久化。“持久存储”功能的与权限相关的标志、算法和类型都设置为权限的标准默认值,只是整个源位置的权限状态必须相同,并且如果未“授予”权限状态(无论出于何种原因,访问持久性存储功能被拒绝),源站点存储单元的box模式总是“尽力”。

+

如果站点或应用程序具有 “永久存储(persistent-storage” 功能权限,则可以使用 {{domxref("StorageManager.persist()")}} 方法来请求将其 box 设为持久的。由于使用特性或其他度量,用户代理还可以决定使站点的存储单元持久化。“持久存储”功能的与权限相关的标志、算法和类型都设置为权限的标准默认值,只是整个源位置的权限状态必须相同,并且如果未“授予”权限状态(无论出于何种原因,访问持久性存储功能被拒绝),源站点存储单元的 box 模式总是“尽力”。

注意:请参考 使用 Permissions API 以了解更多关于申请与管理权限的信息。

-

当清除站点存储单元时,源站的框被视为单个实体;如果用户代理需要清除它并且用户批准,则清除整个数据存储,而不是提供某种仅从单个api清除数据的方法。

+

当清除站点存储单元时,源站的框被视为单个实体;如果用户代理需要清除它并且用户批准,则清除整个数据存储,而不是提供某种仅从单个 api 清除数据的方法。


如果一个框被标记为 “持久(persistent)” ,那么如果没有数据的源代码本身或用户明确地这样做,用户代理将不会清除内容。这包括用户选择“清除缓存”或“清除最近的历史记录”选项等场景。将特别要求用户具有删除永久性站点存储单元的权限。

diff --git a/files/zh-cn/web/api/storageevent/index.html b/files/zh-cn/web/api/storageevent/index.html index 54a86eb6556c6e..c997b1933a656e 100644 --- a/files/zh-cn/web/api/storageevent/index.html +++ b/files/zh-cn/web/api/storageevent/index.html @@ -7,14 +7,14 @@ ---

{{APIRef("Web Storage API")}}

-

当前页面使用的storage被其他页面修改时会触发StorageEvent事件. 

+

当前页面使用的 storage 被其他页面修改时会触发 StorageEvent 事件. 

-

[译者:事件在同一个域下的不同页面之间触发,即在A页面注册了storge的监听处理,只有在跟A同域名下的B页面操作storage对象,A页面才会被触发storage事件] 

+

[译者:事件在同一个域下的不同页面之间触发,即在 A 页面注册了 storge 的监听处理,只有在跟 A 同域名下的 B 页面操作 storage 对象,A 页面才会被触发 storage 事件] 

{{InheritanceDiagram}}

-

Note: 尽管这个事件已经早在 {{ Gecko("2.0") }}时就已存在,但是并不符合规范. 老的事件模型直到 nsIDOMStorageEventObsolete 确定才被表现出来.

+

Note: 尽管这个事件已经早在 {{ Gecko("2.0") }}时就已存在,但是并不符合规范。老的事件模型直到 nsIDOMStorageEventObsolete 确定才被表现出来。

方法描述

@@ -43,12 +43,12 @@

属性

key DOMString - 该属性代表被修改的键值。当被clear()方法清除之后该属性值为null。(只读) + 该属性代表被修改的键值。当被 clear() 方法清除之后该属性值为 null。(只读) newValue DOMString - 该属性代表修改后的新值。当被clear()方法清理后或者该键值对被移除,newValue 的值为 null(只读) + 该属性代表修改后的新值。当被 clear() 方法清理后或者该键值对被移除,newValue 的值为 null(只读) oldValue @@ -58,13 +58,13 @@

属性

storageArea nsIDOMStorage - 被操作的storage对象。(只读) + 被操作的 storage 对象。(只读) url DOMString -

key 发生改变的对象所在文档的URL地址。(只读)

+

key 发生改变的对象所在文档的 URL 地址。(只读)

@@ -74,7 +74,7 @@

方法

initStorageEvent()

-

类似DOM中的初始化事件,即初始化新创建的Storage对象的属性。

+

类似 DOM 中的初始化事件,即初始化新创建的 Storage 对象的属性。

void initStorageEvent(
   in DOMString typeArg,
@@ -92,7 +92,7 @@ 

initStorageEvent()

typeArg
事件名
canBubbleArg
-
布尔值,代表是否可以通过dom冒泡
+
布尔值,代表是否可以通过 dom 冒泡
cancelableArg
布尔值,代表是否可以注销事件
keyArg
@@ -102,9 +102,9 @@

initStorageEvent()

newValueArg
新值
urlArg
-
事件初始化时页面的url
+
事件初始化时页面的 url
storageAreaArg
-
 发生在哪个storage对象上
+
 发生在哪个 storage 对象上

参阅

diff --git a/files/zh-cn/web/api/storagemanager/estimate/index.html b/files/zh-cn/web/api/storagemanager/estimate/index.html index 6f094fa7053909..8a08ffe1a29e03 100644 --- a/files/zh-cn/web/api/storagemanager/estimate/index.html +++ b/files/zh-cn/web/api/storagemanager/estimate/index.html @@ -5,7 +5,7 @@ ---

{{securecontext_header}}{{APIRef("Storage")}}

-

estimate()方法是{{domxref("StorageManager")}}的一个接口,用于估算某一个域名(或一个站点)下Storage Manager的总存储空间和已经使用了的存储空间。此方法为一个异步方法,如果此方法可用,那么其返回一个结果为resolved的{{jsxref("Promise")}}对象。resolved接收的参数是一个带有已使用数据存储空间和总可用总存储空间的{{domxref("StorageEstimate")}}对象。

+

estimate()方法是{{domxref("StorageManager")}}的一个接口,用于估算某一个域名(或一个站点)下 Storage Manager 的总存储空间和已经使用了的存储空间。此方法为一个异步方法,如果此方法可用,那么其返回一个结果为 resolved 的{{jsxref("Promise")}}对象。resolved 接收的参数是一个带有已使用数据存储空间和总可用总存储空间的{{domxref("StorageEstimate")}}对象。

语法

@@ -17,7 +17,7 @@

参数

返回值

-

{{domxref('StorageEstimate')}}类型的状态为resolved的{{jsxref('Promise')}}

+

{{domxref('StorageEstimate')}}类型的状态为 resolved 的{{jsxref('Promise')}}

此数据包含了此应用(或域名)可用的存储空间({{domxref("StorageEstimate.quota")}})和目前已经使用了的存储空间({{domxref("StorageEstimate.usage")}})。

@@ -27,7 +27,7 @@

返回值

示例

-

在这个示例中,我们使用estimate()得到目前所使用的存储空间占全部存储空间的百分比。

+

在这个示例中,我们使用 estimate() 得到目前所使用的存储空间占全部存储空间的百分比。

HTML 内容

diff --git a/files/zh-cn/web/api/storagemanager/index.html b/files/zh-cn/web/api/storagemanager/index.html index 83676931c2b684..a6c742800f71be 100644 --- a/files/zh-cn/web/api/storagemanager/index.html +++ b/files/zh-cn/web/api/storagemanager/index.html @@ -13,9 +13,9 @@

方法

{{domxref("StorageManager.estimate()")}} {{securecontext_inline}}
返回一个{{domxref("StorageEstimate")}}对象,此对象包含为你的域名预留的存储空间总大小和你已经使用的存储空间大小。
{{domxref("StorageManager.persist()")}} {{securecontext_inline}}
-
如果您的user agent能够将你域名下的数据持久保存,那么将返回一个状态为resolve的{{jsxref('Promise')}}
+
如果您的 user agent 能够将你域名下的数据持久保存,那么将返回一个状态为 resolve 的{{jsxref('Promise')}}
{{domxref("StorageManager.persisted()")}} {{securecontext_inline}}
-
如果您的站点已经被授予可使用数据本地存储的权限,则返回一个状态为resolve的{{jsxref('Promise')}}
+
如果您的站点已经被授予可使用数据本地存储的权限,则返回一个状态为 resolve 的{{jsxref('Promise')}}

规范

diff --git a/files/zh-cn/web/api/storagemanager/persist/index.html b/files/zh-cn/web/api/storagemanager/persist/index.html index ce443856b7d832..1f7544ed036839 100644 --- a/files/zh-cn/web/api/storagemanager/persist/index.html +++ b/files/zh-cn/web/api/storagemanager/persist/index.html @@ -5,7 +5,7 @@ ---

{{securecontext_header}}{{APIRef("Storage")}}{{SeeCompatTable}}

-

persist()方法是{{domxref("StorageManager")}}的一个接口,用于请求本地数据存储的权限,如果被授予权限,则返回一个resolved状态值为true的{{jsxref('Promise')}}对象,否则返回false

+

persist()方法是{{domxref("StorageManager")}}的一个接口,用于请求本地数据存储的权限,如果被授予权限,则返回一个 resolved 状态值为true的{{jsxref('Promise')}}对象,否则返回false

语法

@@ -17,7 +17,7 @@

参数

返回值

-

一个resolved状态,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}对象。

+

一个 resolved 状态,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}对象。

示例

diff --git a/files/zh-cn/web/api/storagemanager/persisted/index.html b/files/zh-cn/web/api/storagemanager/persisted/index.html index ddccf2ee03427d..91298fe0977ff3 100644 --- a/files/zh-cn/web/api/storagemanager/persisted/index.html +++ b/files/zh-cn/web/api/storagemanager/persisted/index.html @@ -5,7 +5,7 @@ ---

{{securecontext_header}}{{APIRef("Storage")}}{{SeeCompatTable}}

-

persisted()方法是{{domxref("StorageManager")}}的一个接口,如果盒存储模式(box mode)的值为 “persistent” 则返回一个resolved状态值为true的{{jsxref('Promise')}}。

+

persisted()方法是{{domxref("StorageManager")}}的一个接口,如果盒存储模式(box mode)的值为 “persistent” 则返回一个 resolved 状态值为true的{{jsxref('Promise')}}。

语法

@@ -17,7 +17,7 @@

参数

返回值

-

一个状态为resolved,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}。

+

一个状态为 resolved,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}。

示例