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 对象中删除该键名(如果存在)。 如果没有与该给定键名匹配的项,则此方法将不执行任何操作。
由存储标准描述并使用存储API进行交互的站点存储系统,由每个 {{Glossary("origin")}} 的单个站点存储单元(site storage unit)组成。实际上,每个Web站点或Web应用程序都有自己的存储单元,用于存储数据。下图显示了一个站点存储池,其中包含三个存储单元,显示了存储单元如何可以在其中存储不同的数据类型,并且可能具有不同的配额(最大存储限制)。
+由存储标准描述并使用存储 API 进行交互的站点存储系统,由每个 {{Glossary("origin")}} 的单个站点存储单元(site storage unit)组成。实际上,每个 Web 站点或 Web 应用程序都有自己的存储单元,用于存储数据。下图显示了一个站点存储池,其中包含三个存储单元,显示了存储单元如何可以在其中存储不同的数据类型,并且可能具有不同的配额(最大存储限制)。
@@ -59,13 +59,13 @@如果站点或应用程序具有 “永久存储(persistent-storage
)” 功能权限,则可以使用 {{domxref("StorageManager.persist()")}} 方法来请求将其 box 设为持久的。由于使用特性或其他度量,用户代理还可以决定使站点的存储单元持久化。“持久存储”功能的与权限相关的标志、算法和类型都设置为权限的标准默认值,只是整个源位置的权限状态必须相同,并且如果未“授予”权限状态(无论出于何种原因,访问持久性存储功能被拒绝),源站点存储单元的box模式总是“尽力”。
如果站点或应用程序具有 “永久存储(persistent-storage
)” 功能权限,则可以使用 {{domxref("StorageManager.persist()")}} 方法来请求将其 box 设为持久的。由于使用特性或其他度量,用户代理还可以决定使站点的存储单元持久化。“持久存储”功能的与权限相关的标志、算法和类型都设置为权限的标准默认值,只是整个源位置的权限状态必须相同,并且如果未“授予”权限状态(无论出于何种原因,访问持久性存储功能被拒绝),源站点存储单元的 box 模式总是“尽力”。
注意:请参考 使用 Permissions API 以了解更多关于申请与管理权限的信息。
当清除站点存储单元时,源站的框被视为单个实体;如果用户代理需要清除它并且用户批准,则清除整个数据存储,而不是提供某种仅从单个api清除数据的方法。
+当清除站点存储单元时,源站的框被视为单个实体;如果用户代理需要清除它并且用户批准,则清除整个数据存储,而不是提供某种仅从单个 api 清除数据的方法。
如果一个框被标记为 “持久(persistent
)” ,那么如果没有数据的源代码本身或用户明确地这样做,用户代理将不会清除内容。这包括用户选择“清除缓存”或“清除最近的历史记录”选项等场景。将特别要求用户具有删除永久性站点存储单元的权限。
{{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
确定才被表现出来。
key
DOMString
newValue
DOMString
newValue
的值为 null
。(只读)newValue
的值为 null
。(只读)oldValue
storageArea
nsIDOMStorage
url
DOMString
key 发生改变的对象所在文档的URL地址。(只读)
+key 发生改变的对象所在文档的 URL 地址。(只读)
类似DOM中的初始化事件,即初始化新创建的Storage对象的属性。
+类似 DOM 中的初始化事件,即初始化新创建的 Storage 对象的属性。
void initStorageEvent( in DOMString typeArg, @@ -92,7 +92,7 @@initStorageEvent()
typeArg
canBubbleArg
cancelableArg
keyArg
newValueArg
urlArg
storageAreaArg
{{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")}}对象。
{{domxref('StorageEstimate')}}类型的状态为resolved的{{jsxref('Promise')}}
+{{domxref('StorageEstimate')}}类型的状态为 resolved 的{{jsxref('Promise')}}
此数据包含了此应用(或域名)可用的存储空间({{domxref("StorageEstimate.quota")}})和目前已经使用了的存储空间({{domxref("StorageEstimate.usage")}})。
@@ -27,7 +27,7 @@在这个示例中,我们使用estimate()得到目前所使用的存储空间占全部存储空间的百分比。
+在这个示例中,我们使用 estimate() 得到目前所使用的存储空间占全部存储空间的百分比。
{{securecontext_header}}{{APIRef("Storage")}}{{SeeCompatTable}}
-persist()
方法是{{domxref("StorageManager")}}的一个接口,用于请求本地数据存储的权限,如果被授予权限,则返回一个resolved状态值为true
的{{jsxref('Promise')}}对象,否则返回false
。
persist()
方法是{{domxref("StorageManager")}}的一个接口,用于请求本地数据存储的权限,如果被授予权限,则返回一个 resolved 状态值为true
的{{jsxref('Promise')}}对象,否则返回false
。
一个resolved状态,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}对象。
+一个 resolved 状态,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}对象。
{{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')}}。
一个状态为resolved,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}。
+一个状态为 resolved,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}。