objectStorage.js

objectStorage.js

Simple y ligero para navegadores modernos desarrollado en javascript puro.


Proyecto mantenido por Wilfredo Nina

¿Qué es objectStorage.js?

Es una herramienta que permite almacenar un objeto JSON en el navegador utilizando la funcionalidad localStorage, además te brinda la posibilidad de elegir el almacenamiento entre sessionStorage o localStorage depende cuales sean tus necesidades.

¿Qué necesito?

Un navegador moderno que admita la funcionalidad de localStorage.

¿Cómo se usa?

Incluya dentro de su proyecto el archivo objectStorage.js que debe descargar previamente.

<script type="text/javascript" src="objectStorage.js"></script>

Instanciación

// instancia el objeto 'mi_objeto' para su uso
let mi_objeto = new objectStorage();

Asignación

// asigna el valor '3.1416' en la variable 'pi'
mi_objeto.set('pi', 3.1416);

Obtención

// obtiene el valor de la variable 'pi'
mi_objeto.get('pi');

Eliminación

// elimina la variable 'pi'
mi_objeto.remove('pi');
// elimina todas las variables creadas en la instancia
mi_objeto.clear();

Implementación

// instancia el objeto en un espacio de trabajo como una sesión
let espacio = new objectStorage({
	namespace: 'espacio', // la variable solamente estará disponible en el espacio de trabajo
	storage: 'session' // session o local
});

// define el objeto persona
let persona = {
	nombre: 'pedro',
	edad: 25
};

// asigna el objeto persona a la variable persona
espacio.set('persona', persona);

// obtiene y muestra la variable persona
console.log(espacio.get('persona')); // {nombre: "pedro", edad: 25}

// elimina la variable persona
espacio.remove('persona');

// obtiene y muestra la variable persona
console.log(espacio.get('persona')); // null

Como habrá visto la librería no es tan diferente a la funcionalidad nativa de localStorage, sin embargo el hecho de poder alternar el almacenamiento entre una sesión o local y poder crear un espacio de trabajo lo hace útil; pero el agregado más importante está en que podemos almacenar números, cadenas, arreglos y hasta objetos sin perder su tipo de dato original, es decir podemos manipularlos ya parseados en todo momento.

Soporte o contacto

¿Tienes problemas? Ponte en contacto con wilnicho@gmail.com