Data

jtEssentials.data

Aquí algunas funciones que facilitan la vida respecto al procesado de datos.

Important

Importa jtEssentials directamente en tu proyecto.

Para los ejemplos usaremos la importación directa jtEssentials

import jtEssentials from '@javiert.dev/essentials';

stringify

Esta función permite convertir casi cualquier tipo de dato a un string. Diseñado para que sea más fácil su transporte y almacenamiento. Y de paso podrás encriptarlo si lo necesitas.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
data	Any	Obligatorio		Dato que deseas convertir a string
key	String	Opcional	""	Clave para encriptar la información. Si se proporciona, el resultado será encriptado.

Estructura

jtEssentials.data.stringify(data: any, key: string = ""): string

Ejemplos de uso

let result = jtEssentials.data.stringify({ petType: 'dog', name: 'Naiko', age: 5 });
console.log(result);
//Resultado: "{\"type\":\"object\",\"data\":\"{\\\"petType\\\":\\\"dog\\\",\\\"name\\\":\\\"Naiko\\\",\\\"age\\\":5}\"}"

let result = jtEssentials.data.stringify({ petType: 'dog', name: 'Nuxum', age: 6 }, 'clave de cifrado');
console.log(result);
//Resultado: "U2FsdGVkX1+0v..."

let result = jtEssentials.data.stringify(4);
console.log(result);
//Resultado: "{\"type\":\"number\",\"data\":\"4\"}"

parse

Esta función permite convertir el string generado por la función anteriór a su tipo de dato original. Además, puedes desencriptar la información si lo necesitas.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
data	String	Obligatorio		Dato que deseas convertir a su tipo de dato original
key	String	Opcional	""	Clave para desencriptar la información. Si se proporciona, se asumirá que el dato está encriptado.

Estructura

jtEssentials.data.parse(data: string, key: string = ""): any

Ejemplos de uso

let result = jtEssentials.data.parse("{\"type\":\"object\",\"data\":\"{\\\"petType\\\":\\\"dog\\\",\\\"name\\\":\\\"Naiko\\\",\\\"age\\\":5}\"}");
console.log(result);
//Resultado: { petType: 'dog', name: 'Naiko', age: 5 }

let result = jtEssentials.data.parse("U2FsdGVkX1+0v...", 'clave de cifrado');
console.log(result);
//Resultado: { petType: 'dog', name: 'Nuxum', age: 6 }

let result = jtEssentials.data.parse("{\"type\":\"number\",\"data\":\"4\"}");
console.log(result);
//Resultado: 4

encrypt

Esta función permite encriptar un string usando la librería CryptoJS.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
data	String	Obligatorio		Dato que deseas encriptar
key	String	Obligatorio		Clave para encriptar y desencriptar la información.

Estructura

jtEssentials.data.encrypt(content: string, key: string): string

Ejemplos de uso

let result = jtEssentials.data.encrypt('Hola mundo', 'clave de cifrado');
console.log(result);
//Resultado: "U2FsdGVkX1+0v..."

decrypt

Esta función permite desencriptar un string encriptado con la función anteriór.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
content	String	Obligatorio		Dato que deseas desencriptar
key	String	Obligatorio		Clave para encriptar y desencriptar la información.

Estructura

jtEssentials.data.decrypt(content: string, key: string): string

Ejemplos de uso

let result = jtEssentials.data.decrypt('U2FsdGVkX1+0v...', 'clave de cifrado');
console.log(result);
//Resultado: "Hola mundo"

usid

Esta función permite generar un identificador estático único para un elemento que siempre devolverá el mismo valor para el mismo elemento.

Note

Este generador de USID utiliza MD5 para generar el hash.

Parámetros

Parámetro	Tipo	Requerido	Valor por defecto	Descripción
name	String	Obligatorio		Nombre del elemento que deseas identificar.

Estructura

jtEssentials.data.usid(name: string): string

Ejemplos de uso

let result = jtEssentials.data.usid('ejemplo');
console.log(result);
//Resultado: "2f1767dc31e7a8dc68b2c21bf07984ff"

let result = jtEssentials.data.usid('hola mundo');
console.log(result);
//Resultado: "2f1767dc31e7a8dc68b2c21bf07984ff"