oduplo

duplo

Duplo es una pequeña utilidad para la manipulación de objetos, esta recibe un objeto como primer parámetro y retorna una instancia de duplo con una serie de metodos utiles como :

.set(,)

Permite editar el contenido del objeto mediante , este no elimina nuevas propiedades definidas sino que reemplaza en base a la iteración del nuevo valor

list = duplo({
 list : [1,2,3]
})
list.set('list',[-1])
 
console.log(list) // {list:[-1,2,3]}

como notara set no ha eliminado los otros índices del array

.replace(,)

Permite editar el contenido de un objeto, este reemplaza la totalidad de una propiedad perteneciente al objeto original

list = duplo({
 list : [1,2,3]
})
list.replace('list',[-1])
 
console.log(list) // {list:[-1]}

como notara replace ha remplazado [1,2,3] por [-1]

.get()

por defecto ud puede acceder a todas las propiedades del objeto instanciado con duplo como si fuera el objeto original, pero adicionalmente ud puede hacer uso de get, este permite acceder a las propiedades de un objeto como una expresión sea por ejemplo list[0] esta escaneara el objeto a ver si existe tal propiedad, de esta forma ud puede evitar errores producidos tradicionalmente por propiedades inexistentes

list = duplo({
 list : [1,2,3]
})
 
 
console.log(list.get('list[0]')) // 1
console.log(list.get('list[0].name')) // undefined

como notara get accede a propiedades existentes y regresa undefined para propiedades inexistentes

.toggle()

permite editar el contenido de un objeto, alterando en base a su estado booleano, sea pasar de true a false o de forma alterna, de esta forma ud tendrá una mayor agilidad a la hora de alterar estados booleanos

config = duplo({
   state : {
     header : true,
     body   : true,
     footer : true
   }
})
 
config.toggle('state.header')
console.log(config.get('state.header')) // false

como notara get accede a propiedades existentes y regresa undefined para propiedades inexistentes

.remove()

permite editar el contenido de un objeto, este elimina del objeto una propiedad, en función del tipo que contenga esta propiedad, sea al ser un array usara el método splice de forma contraria usará delete

config = duplo({
   state : {
     header : true,
     body   : true,
     footer : true
   }
})
 
config.remove('state.header')
console.log(config.get('state.header')) // undefined

como notara remove a quitado la propiedad state.header del objeto

.clone()

Retorna un nuevo objeto que duplica el objeto actual en su totalidad, de esta forma ud posee un nuevo objeto sin referencias del anterior sin importar su tamaño

A = duplo({
   items : [1,2,3]
})
 
B = duplo.clone()
 
A.items.push(10)
 
console.log(B.list) // [1,2,3]

de esta forma ud podrá conservar la integridad

.diff()

Retorna las propiedades no diferentes en valor en el objeto original en base al objeto de la comparativa

A = duplo({
   path : 'sample'
})
 
B = duplo({
 path : 'other'
})
 
A.diff(B) // {path:'other'}
 
 

de esta forma ud logra conocer las diferencias entre o objeto

.keys()

permite listar las propiedades existentes en el objeto al igual que lo haría Object.keys()

.length

obtiene el número de propiedades del objeto al igual que lo haría Object.keys(<object>).length