Storage Document

storage

Storage模块管理应用本地数据,用于应用数据的保存和读取。应用本地数据与localStorage、sessionStorage的区别在于数据有效域不同,前者可在应用内跨域操作,并且数据的存储期持久化的。通过plus.storage可获取应用本地数据管理对象。

方法:

权限:

permissions

"Storage": {
	"description": "访问应用本地存储数据"
}
			

getLength

获取storage中保存的键值对的数量

var foo = plus.storage.getLength();
				

参数:

返回值:

Number : 键值对的数量

平台支持:

getItem

通过key值检索键值

var foo = plus.storage.getItem(key);
				

参数:

返回值:

DOMString : 键对应的值,如果没有保存则返回null。

平台支持:

setItem

存储key-value

void plus.storage.setItem(key, value);
				

参数:

返回值:

void : 无

平台支持:

removeItem

通过key值删除键值对

void plus.storage.removeItem(key);
				

参数:

返回值:

void : 无

平台支持:

clear

清除应用所有的键值对

void plus.storage.clear();
				

参数:

返回值:

void : 无

平台支持:

key

获取键值对中指定索引值的key值

var foo = plus.storage.key(index);
				

参数:

返回值:

void : 无

平台支持:

示例:

<!DOCTYPE html>
<html>
	<head>
		<meta charset="UTF-8"/>
		<script type="text/javascript">
function loadAllKeyValue() {
	var keyNames[];
	var values[];
	var numKeys = plus.storage.getLength();
	for(var i=0; i<numKeys; i++) {
		keyNames[i] = plus.storage.key(i);
		values[i] = plus.storage.getItem(keyNames[i]);
	}
}
		</script>
	</head>
	<body>

	</body>
</html>