📚 JavaScript: breves anotaciones sobre el lenguaje

Listado personal de anotaciones, trucos, recordatorios, utilidades o ejemplos interesantes para JavaScript.

Tabla de Contenido

• Versiones de JavaScript
• Tipos de datos
• Declaración de variables
• Operadores
• Condicionales
• Continue, break y label
• Funciones, parámetros y argumentos
• Clases en ES6
• Clases en ES2022
• Singleton (ES6 clase)
• Tratamiento de arrays
• Tratamiento de strings
• Regular expressions
• Objetos
• Namespaces
• Closures
• Curry functions
• Proxies
• Set
• Map
• Debugging y console
• De callback hell a promesas
• Promesas
• Async-Await
• setTimeout
• setInterval
• DOM
• ECMAScript modules vs CommonJS modules on Node.js
• unhandledRejection on Node.js
• Fetch
• Switch vs mapper
• API Intl
• Navigator Interface
• Debounce

---

Versiones de JavaScript:

Compatibilidades con Node.js

https://node.green

Compatibilidades con browsers

https://kangax.github.io/compat-table

Compatibilidades con navegadores (exceptuando IE11)

• En junio de 2021, ES2017 está totalmente soportado en todos los navegadores principales de escritorio y móvil
• En diciembre de 2022, ES2020 está totalmente soportado en todos los navegadores principales de escritorio y móvil
• En marzo de 2023, ES2021 está totalmente soportado en todos los navegadores principales de escritorio y móvil

---

Tipos de datos:

Hay dos conjunto de tipos en JavaScript:

• Los tipos primitivos: null, undefined, boolean, number (incluyendo NaN), string, symbol y bigint.
• Los tipos objeto: Object, Array, Map, Set, Date, Error, Promise, Function, ...

Los tipos primitivos se pasan por valor. Pero los tipos objeto se pasan por referencia.

Nota: Pese a que typeof null retorne object, null es un tipo primitivo. Esto es debido a un error que se cometió en la creación de JavaScript.

---

Declaración de variables:

• Declarar múltiples variables de manera más compacta:

var i, j, k;
var l = m = n = 0;
var a = 1, b = 2;

---

Operadores:

• Operador lógico OR (evalua de izquierda a derecha las expresiones y retorna la primera de ellas evaluable como "truthy". Si todas se evaluan como "falsy", retorna false. Todos los valores son "truthy", excepto: false, 0, "", null, undefined, y NaN)

var foo = false || '🙂'; // '🙂'

var bar = 3 || false; // 3

var foobar = null || 0 || undefined || "NyanCat"; // "NyanCat"

• Operador ternario: ?:

var now = new Date();  
var greeting = "Good" + ((now.getHours() > 17) ? " evening." : " day.");
console.log(greeting);

• Operador spread:

let foo = ['foo 1', ' foo 2'];
let bar = ['bar 1', 'bar 2', ...foo, 'bar 3'];
console.log(bar); // ["bar 1", "bar 2", "foo 1", " foo 2", "bar 3"]

• Doble uso del operador ! (not):

// La doble negación retorna un booleano dependiendo de la "truthiness" de la expresión.
// Retornará false cuando el valor sea: false, 0, "", null, undefined, y NaN.
// Si no es ninguno de estos casos, entonces devolverá true.
// Tiene sentido usarlo para evaluar expresiones que no son booleanas.
let foo;
if (!!foo) { // 'Result is false' Dado que el valor de foo es null.
	console.log('Result is true');
} else {
	console.log('Result is false');
}

// Observa los siguientes ejemplos:
!!0 // false
!!1 // true
!!"" // false (string vacío es falsy)
!!window.biz // false (si la variable biz no está declarada, se evalua como falsy)
!!undefined // false (undefined es falsy)
!!null // false (null is falsy)
!!{} // true (an empty object is truthy)
!![] // true (an empty array is truthy. PHP programmers beware!)
!!NaN // false

• Nullish coalescing operator (??):

0 ?? 'default' // 0
'' ?? 'default' // ''
false ?? 'default' // false
NaN ?? 'default' // NaN
null ?? 'default' // 'default'
undefined ?? 'default' // 'default'
undefined ?? null // null
null ?? undefined // undefined


// Ejemplo de uso combinado con asignación
const buildConfig = (options) => {
	options.duration ??= '44';
	options.speed ??= '300';
	options.debug ??= true;
	options.name ??= null;

	return options;
};

buildConfig({ duration: '123' }); // { duration: '123', speed: '300', debug: true, name: null }
buildConfig({debug: false, name: 'foo'}); // { debug: false, name: 'foo', duration: '44', speed: '300' }

• Optional chaining operator (?.):

const object = { id: 123, names: { first: 'Alice', last: 'Smith' }};
const firstName = object?.names?.first; // 'Alice'
const home = object?.address?.home; // undefined

// En combinación con nullish coalescing operator:
const middleName = object?.names?.middle ?? '(no middle name)'; // '(no middle name)'


const user = {};
alert(user.address.street); // Error!
alert( user && user.address && user.address.street ); // undefined (no error)
alert( user?.address?.street ); // undefined (no error)


// the evaluation stops immediately after: car?.
const car = null;
alert( car?.motor.valves.anything ); // undefined

---

Condicionales:

• Condicional if comparando múltiples criterios:

const fruit = 'strawberry';

// Creamos un array con aquellos criterios a los que comparar
const criteria = ['apple', 'strawberry', 'cranberries'];

if (criteria.includes(fruit)) {
	// true
}

---

Continue, break y label:

El uso de continue, break y label es muy interesante y puede ser útil en algunos casos.
De todas formas, si estás haciendo uso de labels quizás debas plantearte que algunas veces puede ser más legible separar el código en funciones, lanzar una excepción o cualquier otra alternativa antes del uso de las mismas.

• Uso de continue:

let text = '';

for (let i = 0; i < 5; i++) {
	if (i === 3) {
		continue; // Skip an iteration of the loop
	}
	text = text + i;
}

console.log(text); // '0124'

• Uso de break:

let text = '';

for (let i = 0; i < 5; i++) {
	if (i === 3) {
		break; // Stop the loop
	}
	text = text + i;
}

console.log(text); // '012'

• Uso de continue y label:

const data = [
  ['cat', 'lion'],
  ['mouse', 'cat', 'tiger'],
  ['frog', 'fish', 'cat'],
];

const valuesBeforeCat = [];

// "outerLoop" is a label to identify the first loop
outerLoop: for (let i = 0; i < data.length; i++) {
   for (let j = 0; j < data[i].length; j++) {
      if (data[i][j] === 'cat') {
        continue outerLoop; // we force a "continue" on the outer loop!
      }
     
     valuesBeforeCat.push(data[i][j]);
   }
}

console.log(valuesBeforeCat); // [ 'mouse', 'frog', 'fish' ]

• Uso de break y label:

let text = '';

outerLabel: { // "outerLabel" is the name of a label to identify a code block
	text += 'a';
	
	for (let i = 0; i < 5; i++) {
		if (i === 3) {
			break outerLabel; // we force a break of a code block identified by label "outerLabel"
		}
		
		text += i;
	}
	
	text += 'z'; // this line is not executed!
}

console.log(text); // 'a012'

---

Funciones, parámetros y argumentos:

• Parámetros vs argumentos. Un parámetro es una variable en la declaración de la función. Un argumento es el valor que le pasas a una función en el momento de ser llamada:

function sayHi(name) { // 👈 parameter
}

sayHi('samantha'); // 👈 argument

• arguments (array de argumentos que se le pasan a una función):

function printArgumentsES6(...arg){
	arg.forEach((a) => console.log(a));
}
printArgumentsES6(3712,7123);

function printArgumentsES6ForOf(){
	for(let argument of arguments){
		console.log(argument);
	}
}
printArgumentsES6ForOf(3712,7123);


function food(...arg){
	const [egg, cheese] = args;
}
food('🥚', '🧀');

• Uso de destructuring para mejorar la legibilidad del siginificado de los parámetros que mandamos a una función:

function createMenu({ title, body, buttonText, cancellable=false }) {
	// ...
	// Fíjate que establecemos un valor por defecto al argumento "cancellable"
}

createMenu({
	title: 'my title',
	body: 'my body',
	buttonText: 'send form',
	cancellable: true
}); // observa que así es totalmente comprensible el significado de los parámetros. A esto lo llamamos "named parameters".
// Sin embargo, no hubieramos entendido nada así: createMenu('my title', 'my body', 'send form', true);
// ¿Sabríamos entender que significa el true en la segunda llamada? Probablemente no!

// Podemos hacer lo siguiente si todos los parámetros son opcionales:
function createUser({ username = 'Anonymous' } = {}) {
	// ...
}
// de esta manera podemos llamar a la función así:
createUser();

// Observa que si nuestras funciones también retornan objetos, estás usando el patrón RORO (receive object, return object).

• Self Invoking Functions, también llamadas IIFE (Immediately Invoked Function Expression):

var hello;
(function (){

	hello = function(){
		return "Hi boy!";
	};

})();

console.log( hello() ); // "Hi boy!"


var result = (function () {
	var name = "Barry";
	return name;
})();

console.log(result); // El contenido de la variable result es el resultado de la ejecución de la función.
// En este caso: "Barry"

• Factory Functions (una "Factory Function" es una función que crea objetos y los retorna):

// Ejemplo de Factory Function
const cat = () => {

	const sound = 'miau';
	let color = 'white';

	// definimos getters and setters para acceder a las propiedades
	const setColor = (newColor) => {
		color = newColor;
	}
	const getColor = (newColor) => {
		return color;
	}

	return {
		talk: () => sound,
		setColor,
		getColor
	}
}

const smurfy = cat(); // No debes usar "new"!
console.log( smurfy.talk() ); // miau
// console.log( smurfy instanceof cat ); // TypeError
console.log( smurfy.getColor() ); // 'white'
smurfy.setColor('black');
console.log( smurfy.getColor() ); // 'black'


// Otro ejemplo potenciando el uso de "closures"
const makeCounter = function() {
	// propiedades privadas
	let _count = 0;

	// métodos privados
	const changeBy = (val) => {
		_count += val;
	}

	// definimos los métodos publicos
	return Object.freeze({
		increment: function() {
			changeBy(1);
		},
		decrement: function() {
			changeBy(-1);
		},
		getValue: function() {
			return _count;
		}
	})
};

const Counter1 = makeCounter();
const Counter2 = makeCounter();

console.log(Counter1.getValue()); // 0

Counter1.increment();
Counter1.increment();
console.log(Counter1.getValue()); // 2

Counter1.decrement();
console.log(Counter1.getValue()); // 1

console.log(Counter2.getValue()); // 0

Otro ejemplo de Factory Functions más avanzado:

// Ejemplo avanzado de Factory Function:
const dataConnection = (data = {}) => {
	const settings = data; // Guardo los parámetros que me han pasado al llamar a la factory function.
	// De esta manera puedo definir propiedades del nuevo objeto.
	
	return Object.freeze({
		// Object.freeze evita la eliminación y adición de propiedades, modificación del prototype, etc.
		getSettings: () => settings,

		modifySettings: (addData = {}) => {
			return Object.assign(settings, addData); 
		// Añadimos al objeto 'settings' nuevas propiedades
		// o bien modificamos el valor de las existentes.
		}
	});
}

const connection = dataConnection( { ip: '127.0.0.1', port: '8080' } );
// Le paso como parámetro un objeto

console.log( connection.getSettings() ); // {ip: "127.0.0.1", port: "8080"}
console.log( connection.getSettings().ip ); // 127.0.0.1

connection.method = 'http'; // Esto NO funcionará!
// Gracias a 'Object.freeze' no puedo añadir propiedades al objeto.
// Sólo veré un error si uso: 'use strict';

//connection.settings.method = 'http'; // Esto NO funcionará! TypeError

connection.modifySettings( { method: 'http' } );
// Usamos un método definido en el objeto para modificar los valores que contiene el objeto.

console.log( connection.getSettings() ); // {ip: "127.0.0.1", port: "8080", method: "http"}

connection.modifySettings( { ip: '192.168.2.11' } );
// Podemos sobreescribir los valores del objeto 'settings'.

console.log( connection.getSettings() ); // {ip: "192.168.2.11", port: "8080", method: "http"}

---

Clases en ES6

• Ejemplo de clase:

class Person {
	constructor(name) {
		// constructor es un método opcional. Si la clase no tiene propiedades puedes omitirlo
		this.name = name;
	}

	salute() {
		console.log(`Hello, my name is ${this.name}`);
	}
}

let john_doe = new Person('John Doe');

john_doe.salute(); // Hello, my name is John Doe

console.log(john_doe instanceof Person); // true
console.log(john_doe instanceof Object); // true

console.log(typeof john_doe); // object

console.log(typeof Person); // function !!
// (Cuidado, podríamos pensar que nos retornará 'class' pero nos retorna 'function')

• Observa el uso del contexto (this) en los diferentes métodos:

class Person {
	constructor(name) {
		this.name = name;

		// La próxima linea es opcional, pero permite que 'this' funcione correctamente dentro del método cuando el método se extrae a una variable.
		// this.salute = this.salute.bind(this);
	}

	// Utilizar arrow functions permite el bindeo correcto de 'this' cuando el método se extrae a una variable.
	greet = () => {
		console.log(`Hello, my name is ${this.name}`);
	}

	// Observa que no estoy usando una arrow function aquí:
	salute() {
		console.log(`Hello, my name is ${this.name}`);
	}
}

let julia = new Person('Julia');
julia.greet(); // Hello, my name is Julia
julia.salute(); // Hello, my name is Julia

console.log(typeof Person.prototype.greet); // undefined !!
// (Cuidado, podríamos pensar que nos retornará 'method' o 'function' pero nos retorna 'undefined')

console.log(typeof Person.prototype.salute); // function !!
// (Cuidado, podríamos pensar que nos retornará 'method' pero nos retorna 'function')

const greetMethod = julia.greet; // extraigo el método a una variable
greetMethod(); // Esto funciona correctamente, ya que declaré el método greet usando arrow function, la cual hizo el bindeo de 'this'.

const saluteMethod = julia.salute;
saluteMethod(); // TypeError: Cannot read properties of undefined (reading 'name')
// Esto NO funciona porque el método 'salute' no tiene bindeado 'this'


// Sin embargo, podrías llegar definirle el contexto en otro momento. 
const peter = new Person('Peter');
const salute = peter.salute.bind(peter);
salute(); // Esto funcion porque le has bindeado el contexto

// incluso podría bindearle otro contexto distinto: 
const otherObject = {
	name: 'Mariah'
}
const saluteCrossBinded = peter.salute.bind(otherObject);
saluteCrossBinded(); // 'Hello, my name is Mariah'

• Ejemplo de Chaining Methods (métodos encadenados):

class Car {
	constructor(brand, model, color) {
		this.brand = brand;
		this.model = model;
		this.color = color;
	}

	setBrand(brand) {
		this.brand = brand;
		return this; // Returning this for chaining
	}
	setModel(model) {
		this.model = model;
		return this; // Returning this for chaining
	}
	setColor(color) {
		this.color = color;
		return this; // Returning this for chaining
	}

	getCarInfo() {
		return this; // Returning this for chaining
	}
}

const car = new Car('Ford','F-150','red').setColor('pink').setModel('Fiesta'); // Chaining methods!

console.log( car.getCarInfo() ); // {brand: "Ford", model: "Fiesta", color: "pink"}

• Métodos estáticos (nos permite usar esos métodos sin generar la instancia de la clase):

class Utilities {
	static getRandomInteger() {
		// Esto es un método estático. 
		// Permite ser llamado sin necesidad de instanciar la clase.
		return Math.floor(Math.random() * 11); // retorna número entero aleatorio entre 0 y 10
	}

	static coinToss() {
		return Math.random() > 0.5; // retorna "true" o "false" de manera aleatoria
	}

	static capitalize(str) {
		return str.charAt(0).toUpperCase() + str.slice(1); // retorna un string poniendo en mayúscula la primera letra
	}

	static delay(milliseconds, callback) {
		setTimeout(callback, milliseconds);
	}

	static trimToTwoDecimalPoints(number) {
		const fixed = 2;
		return ~~(Math.pow(10, fixed) * number) / Math.pow(10, fixed);
	}

	/**
	 * Get a random float between the min and max parameters
	 *  @example
	 *      getRandomPriceBetweenRange(6, 7); // 6.98
	 * @param {number} min
	 * @param {number} max
	 * @returns {number}
	 */
	static getRandomPriceBetweenRange(min, max) {
		const randomNumber = Math.random() * (max - min) + min;
		return Number(randomNumber.toFixed(2));
	}

	static pause(milliseconds) {
		const start = Date.now();
		let now = start;
		while (now - start < milliseconds) {
			now = Date.now();
		}
	}

	static waitFor(milliseconds) {
		return new Promise(resolve => setTimeout(resolve, milliseconds));
	}

	static generateToken() {
		const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789#*'; // Don't modify the length
		let rand;
		let index;
		let bits = 64;
		let result = '';
		while (bits > 0) {
			rand = Math.floor(Math.random() * 0x100000000); // 32-bit integer
			// base 64 means 6 bits per character, so we use the top 30 bits from rand to give 30/6=5 characters.
			for (index = 26; index > 0 && bits > 0; index -= 6, bits -= 6) {
				result += chars[0x3F & (rand >>> index)];
			}
		}

		return result;
	}

	static randomString() {
		const length = 16;
		const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
		const charactersLength = characters.length;

		let result = '';

		while (result.length < length) {
			result += characters.charAt(Math.floor(Math.random() * charactersLength));
		}

		return result;
	}
}

const num = Utilities.getRandomInteger(); // Llamamos directamente al método estático
console.log(num); // 2

console.log(Utilities.coinToss()); // true | false

console.log(Utilities.capitalize('batman')); // 'Batman'

Utilities.delay(3000, function () {
	return console.log('delayed output');
}); // 'delayed output', tres segundos después

Utilities.generateToken(); // 'DyvlJ*mhQ8X'

Utilities.pause(2000); // Stop the execution of JavaScript for the specified time

// waitFor() example:
Utilities.waitFor(5000).then(() => doSomething());

// or even...
await Utilities.waitFor(5000);
doSomething();

• Herencia:

class Rectangle {
	constructor(len, wid) {
		this.len = len;
		this.wid = wid;
	}

	getArea() {
		return this.len * this.wid;
	}

	getInfo () {
		return 'I am a naughty rectangle!';
	}
}

class Square extends Rectangle { // extendemos la clase
	constructor(len) {
		super(len, len); // Invocamos al constructor de la clase padre
	}

	// Podría hacer referencia al método del padre, pero no es necesario!
	// Puedo omitirlo, ya que el método es heredado automáticamente.
	// getArea() {
	// 	return super.getArea(); // Fíjate que así invoco a un determinado método del padre.
	// }

	// Sobreescribir un método
	getInfo () {
		return 'I am a cheeky square!';
	}
}

let square = new Square(4);
console.log(square.getArea()); // 16. Observa que este método ha sido hererado de la clase padre

console.log(square instanceof Square); // true
console.log(square instanceof Rectangle); // true. Recuerda que Square extiende la clase Rectangle

console.log(square.getInfo()); // I am a cheeky square!

---

Clases en ES2022

• Ejemplo de clase en ES2022:

class MyES2022Class {
	// no es necesario el constructor para declarar las propiedades públicas (pero puedes usarlo si lo necesitas).

	x = 1; // public property

	#counter = 0; // private property

	static z = 3; // static property

	incB() {
		this.#counter++;
	}

	getCounter() {
		return this.#counter
	}

}

let foo = new MyES2022Class();

foo.incB(); // runs OK
foo.#counter = 7; // error - private property cannot be modified outside class
foo.#counter; // error - private property cannot be read outside class
foo.counter; // undefined

foo.getCounter(); // 1

---

Singleton (ES6 clase):

• Ejemplo de singleton pattern usando clases de ES6:

class Item {
	constructor(){
		if (Item.instance) {
			return Object.freeze(Item.instance);
		}
		this._data = [];
		Item.instance = this;
	}

	// Methods
	add(item){
		this._data.push(item);
	}

	get(id){
		return this._data.find(d => d.id === id);
	}
}

// Puedes exportar esta clase como un módulo:
module.exports = Item;

// Impórtalo así:
const Item = require('./Item');
const foo = new Item();

let first = new Item();
let second = new Item();

first.add( { id: 1, name: 'john' } );
first.add( { id: 2, name: 'louis' } );

console.log(second); // [ {id: 1, name: "john"}, {id: 2, name: "louis"} ]

console.log(second.get(2)); // { id: 2, name: 'louis' }

console.log(first===second); // true (son la misma instancia)

---

Tratamiento de arrays:

• Crear un array con n número de posiciones con un valor por defecto

new Array(3).fill(0); // [0,0,0]

• Clonar un array

/**
 * recursiveArrayClone() Crea un clon exacto de un array. Soporta matrices multidimensionales.
 *
 * @code
 * 	console.log( recursiveArrayClone( ['a', {}, [4, 0]] ) ); // ['a', {}, [4, 0]]
 * @endcode
 *
 * @param {array} arrayToClone. El array que se quiere clonar.
 * @return {array} clonedArray. Retorna un nuevo array.
 */
function recursiveArrayClone(arrayToClone){
	let clonedArray = [];
	for (let i = 0; i < arrayToClone.length; i++) {
		if ( Array.isArray(arrayToClone[i]) ) {
			clonedArray.push( recursiveArrayClone(arrayToClone[i]) );
		} else {
			clonedArray.push(arrayToClone[i]);
		}
	}
	return clonedArray;
}

• Vaciar un array

const myArray = ['a', 'b', 'c'];
myArray.length = 0;
console.log(myArray); // []

• Quitar elementos falsy de un array

const myArray = [0, "0", "example", null, undefined, NaN, false];

let arrayFiltered = myArray.filter(Boolean);
console.log(arrayFiltered); // ["0", "example"]

• Uso de: array.join (retorna un string)

let a = ['Wind', 'Rain', 'Fire'];
a.join();      // 'Wind,Rain,Fire'
a.join('');    // 'WindRainFire'


let text = "Add the potato please, I always prefer more potato";
text = text.split("potato").join("cheese");
// Sustituye "potato" por "cheese" en todas las apariciones que haya en "text"

• Uso de: array.concat (crea un nuevo array con la concatenación de 2 o más arrays)

const arr1 = ['a', 'b', 'c'];
const arr2 = ['d', 'e', 'f'];
const arr3 = arr1.concat(arr2); // arr3 is a new array [ "a", "b", "c", "d", "e", "f" ]

• Uso de: array.slice (crea una copia del array pero quitando, o no, algunos elementos del original)

var fruits = ['Banana', 'Orange', 'Lemon', 'Apple', 'Mango'];
var citrus = fruits.slice(1, 3); // citrus == ['Orange','Lemon']


var reduced_fruits = fruits.slice(1); // reduced_fruits == ['Orange', 'Lemon', 'Apple', 'Mango']

• Uso de: array.splice (permite añadir o eliminar elementos a un array. También es útil para partir un array en dos)

var instruments = ['guitar', 'bass', 'saxophone'];
instruments.splice(2, 0, 'drums'); // instruments == ['guitar', 'bass', 'drums','saxophone']


var planets = ['Mercury','Venus','Earth','Mars','Pluto','Jupiter','Saturn','Uranus','Neptune'];
planets.splice(4,1);
// (sorry, Pluto) planets == ['Mercury','Venus','Earth','Mars','Jupiter','Saturn','Uranus','Neptune']


array_example.splice(0, 0, "foo"); // Añade "foo" a la primera posición de un array


var myFish = ['angel', 'clown', 'mandarin', 'sturgeon', 'cherubfish'];
var removedFish = myFish.splice(2);
console.log(myFish); // ["angel", "clown"]
console.log(removedFish); // ["mandarin", "sturgeon", "cherubfish"]

• Uso de: array.indexOf (busca un determinado elemento en un array)

var a = ["foo", "bar", "biz"]; 
a.indexOf("bar"); // 1 
a.indexOf("NyanCat"); // -1

if (a.indexOf("NyanCat") === -1) {
	// element doesn't exist in array
}

• Uso de: array.filter (crea un nuevo array a partir de otro con aquellos elementos que pasan el filtro especificado)

function isBigEnough(value) {
	return value >= 10;
}

const numbers = [12, 5, 8, 130, 44];

const filteredNumbers = numbers.filter(isBigEnough); // filteredNumbers is [12, 130, 44]

• Uso de: array.map (crea un nuevo array a partir de realizar una función en cada uno de los elementos del array original)

var numbers = [1, 4, 9];
var roots = numbers.map(Math.sqrt); // roots is now [1, 2, 3]


var nums = [1,2,3];
var doubleNums = nums.map(
	function(number){
		return number * 2;
	}
);
// doubleNums is now [2, 4, 6]
 

// Trick!
['1', 2, '3', 4, '5'].map(Number); // [1, 2, 3, 4, 5]

• Uso de: array.forEach (recorre el array aplicando una función a cada elemento)

var a = ['a', 'b', 'c'];
a.forEach(function(element) {
	console.log(element);
});

// Otra manera de implementarlo:
function fooFunction(currentValue,index,array) {
	// ...
}
a.forEach(fooFunction, this); // Podemos nombrar la función en vez de declararla dentro del forEach.
// Adicionalmente, podemos pasarle el objeto 'this' a la función.

• Uso de: array.reduce (aplica una función a un acumulador y a cada valor de un array (de izquierda a derecha) para reducirlo a un único valor.)

const cart = [ {ref: "yuh", price: 23}, {ref: "jum", price: 44} ];
const result = cart.reduce(function(accum, v){
	return accum + v.price;
},0); // en este caso, el 0 es el acumulador.
console.log(result); // 67


const arrayOfBooleans = [true, false, true, true];
const totalOfTrues = arrayOfBooleans.reduce( function(accumulator, arrayElement){
			return arrayElement ? ++accumulator : accumulator;
		},0
	);
console.log(totalOfTrues); // 3

• Array.push vs Array.push.apply

const numbers = [1, 2, 3, 4, 5];
const someNumbers = [6, 7];
const moreNumbers = [8, 9];

numbers.push(someNumbers);

/* Al utilizar "apply", el primer parámetro será considerado el objeto "this", el segundo parámetro debe ser un array */
/* Al combinarlo con push conseguimos aplicar un push por cada uno de los elementos del array "moreNumbers" */
numbers.push.apply(numbers, moreNumbers);

console.log(numbers); // [ 1, 2, 3, 4, 5, [ 6, 7 ], 8, 9 ]

const extraNumbers = [10, 11];
/* Sin embargo, es más sencillo hacer esto */
numbers.push(...extraNumbers);

console.log(numbers); // [ 1, 2, 3, 4, 5, [ 6, 7 ], 8, 9, 10, 11 ]

• Manera eficiente de partir un array en otros arrays más pequeños. Atención, solo usar con arrays de una dimensión que contenga valores primitivos.

const splitArrayInChunks = (myArray, chunkSize = 100) => {
  if (chunkSize <= 0) {
    throw new Error('The value of chunkSize should be an integer greather than 0');
  }
  const results = [];

  const copiedArray = [...myArray];
  while (copiedArray.length) {
    results.push(copiedArray.splice(0, chunkSize));
  }

  return results;
};

splitArrayInChunks([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]

---

Tratamiento de strings:

• Uso de: string.match (crea un array a partir de comparar un string con una regular expression)

var str = "The rain in SPAIN stays mainly in the plain"; 
var res = str.match(/ain/gi); // ["ain","AIN","ain","ain"]


var text = "The phone number is 93 555 22 33";
var result = text.match(/\d+/); // ["93"]
var allResults = text.match(/\d+/g); // allResults is ["93", "555", "22", "33"]
var numberOfResults = text.match(/\d+/g).length; // 4


var text = "<p>Hello {{name}}, you are {{age}} years old.</p>";
var extract = text.match(/\{\{(.+?)\}\}/g);
console.log(extract); // ["{{name}}", "{{age}}"]

• Diferencias entre string.substr y string.substring (ambos métodos retornan un nuevo string a partir del original, pero observa la diferencia de resultados):

var text = "Example";
console.log(text.substr(1,5)); // "xampl" 
// (a partir del índice dado, retorna tantos caracteres como indiques en el segundo parámetro)


console.log(text.substring(1,5)); // "xamp" 
// (a partir del índice dado, retorna caracteres hasta el otro índice dado)

• Uso de: string.split (genera un nuevo array a partir de trocear un string por el parámetro indicado)

var array_of_words = "A new car".split(" ");
console.log(array_of_words); // ["A", "new", "car"]


console.log( "hello".split("") ); // ["h", "e", "l", "l", "o"]


var text = "Add the potato please, I always prefer more potato";
text = text.split("potato").join("cheese");
// Sustituye "potato" por "cheese" en todas las apariciones que haya en "text"

---

Regular expressions:

• Uso de: regexObj.test (retorna un boolean que indica si se encuentra una coincidencia en el string dado)

var str = "The best things in life are free";
var pattern = new RegExp(/life/g);
var res = pattern.test(str); // true

---

Objetos:

• Contexto de this:

var biz = {
	nombre: "Dídac",
	"nombre-apellido": "Dídac García", // entrecomillado por contener un guión!

	// error, "this" apunta al objecto global:
	saludar: 'Hola, soy ' + this.nombre,

	// correcto, "this" apunta a "biz":
	presentarse: function(){
		return 'Mi nombre es ' + this.nombre;
	},

	get nombreCompleto() { return this["nombre-apellido"]}
}

console.log(biz.saludar); // 'Hola, soy undefined'
console.log(biz.presentarse()); // 'Mi nombre es Pedro'

console.log(biz.nombreCompleto); // "Dídac García"

console.log(biz.nombre-apellido); // Error!
console.log(biz["nombre-apellido"]); // "Dídac García"

delete biz["nombre-apellido"]; // Siempre retorna true! Incluso cuando no existe la propiedad a borrar

• Obtener un array a partir de las propiedades de un objeto:

var foo = {
	nombre: 'Juan',
	apellido: 'Ruiz'
}

var arrayOfProperties = Object.keys(foo);
console.log(arrayOfProperties); // ['nombre', 'apellido']

• Crear un array a partir de un objeto:

var biz = {
	length: 2,
	'0': 'biz',
	'1': 'foo'
}

var arrayFromObject = Array.prototype.slice.call(biz);
console.log(arrayFromObject); // ['biz', 'foo']
console.log(arrayFromObject.length); // 2
console.log(arrayFromObject[1]); // 'foo'

• Clonar un objeto de manera profunda es una tarea realmente compleja en JavaScript. Te muestro diferentes métodos con sus respectivos trade-offs:

/**
 * Esta función te permite hace clonaciones profundas gracias a la recursividad. 
 * Este método si te clonara funciones dentro de los objetos, pero no funcionará con Set, Map, Null, RegExp, Date, Array, ArrayBuffer, etc...
 * Por tanto, no es un método muy bueno para clonar objetos ☹️
 */
function deepClone(originalObject) {
	const clonedObject = {};
	for (const key in originalObject) {
		if (typeof (originalObject[key]) !== 'object') {
			clonedObject[key] = originalObject[key];
		} else {
			clonedObject[key] = deepClone(originalObject[key]);
		}
	}
	return clonedObject;
}
const newObject = deepClone(originalObject);

/**
 * Este método tampoco es válido, ya que fallará silenciosamente si el objeto a clonar tiene funciones. ☹️
 * Tampoco funcionará con Set, Map, RegExp, Date o ArrayBuffer
 */
const problematicObject = {
  set: new Set([1, 3, 3]),
  map: new Map([[1, 2]]),
  regex: /foo/,
  deep: { array: [ new File(someBlobData, 'file.txt') ] },
  error: new Error('Hello!'),
  aFunction: () => { console.log('') }
}

const veryProblematicCopy = JSON.parse(JSON.stringify(problematicObject)

/**
 * Este método tampoco es válido, ya que no creará la copia correctamente si, por ejemplo, una de las propiedades contiene un objeto de tipo Date (objeto original y su copia compartirán el objeto Date, no se hace una copia). 
 * El mismo problema ocurrirá si una de las propiedades del objeto es un array! ☹️
 * Tendrás problemas similares con: Object.create() ☹️
 */
const obj = { a: 1 };
const copy = Object.assign({}, obj);
console.log(copy); // { a: 1 }


/**
 * Esto es uno de los métodos más modernos para clonar objetos (Node 17 en adelante, tiene soporte en todos los browsers modernos).
 * Sin embargo, sigue siendo problemático en algunos objetos que contienen: funciones (structuredClone lanzará un error), Error (no soporta todos los tipos de error, pero si los más comunes), elementos el DOM, getters y setters.
 * Además el prototype de los objetos clonados se pierde.
 * Sin embargo, si funciona bien con: Date, Set, RegExp, Map, Array, etc...
 */
const mushrooms1 = {
  amanita: ["muscaria", "virosa"],
};

const mushrooms2 = structuredClone(mushrooms1);


/**
 * Finalmente, aquí tienes uno de los métodos más populares y sencillos para resolver el problema
 * Cuidado, esto cubre la mayoría de los casos, pero no es infalible. En cualquier caso, es probablemente la mejor opción para clonados profundos de objetos
 */
// npm i --save lodash.clonedeep // https://www.npmjs.com/package/lodash.clonedeep
import cloneDeep from 'lodash.clonedeep';


/**
 * Hay muchas otras soluciones, pero todas tiene su contrapartida. 
 * 
 * Incluso patros de diseño creacionales como "prototype" o "singleton" podría servir para solucionar este problema:
 *  - prototype => el propio objeto incluye un método para clonarse de manera específica y controlada.
 *  - singleton => quizás no necesites un clonado, si no trabajar siempre con el mismo objeto
 */

• Iterar un objeto:

const obj = {
   id:1,
   name: "gowtham",
   active: true
}

for (const key in obj){
	console.log(`${key} : ${obj[key]}`) // "name : gowtham" En la segunda iteración.
}

// Otra opción!
Object.keys(obj).forEach( key => {
	console.log(`${key} : ${obj[key]}`);
});


// Si sólo nos interesan los valores
Object.values(obj).forEach( value => {
	console.log(value);
});

// Esto incluye las propiedades non-enumerables
Object.getOwnPropertyNames(obj).forEach( key => {
	console.log(`${key}:${obj[key]}`);
})

// esto solo itera las propiedades que sean "enumerables" y "non-inherit"
for (const [key, value] of Object.entries(obj)) {
  console.log(`${key}: ${value}`);
}

• Crea un objeto literal a partir de los parámetros de una URL:

// On this URL: https://example.com/index.php?foo=foo&bar=bar

Object.fromEntries([...new URL(location).searchParams]); // {foo: "foo", bar: "bar"}

• Comprobar si un objeto tiene una determinada propiedad.

Las propiedades de los objetos en Javascript son propiedades enumerables y no enumerables. Las propiedades de los objetos nativos de Javascript están definidas como no enumerables. Sin embargo, cuando nosotros añadimos o definimos una propiedad a un objeto esta propiedad se crea de manera enumerable.

Las propiedades también son heredadas o no heredadas. Las propiedades heredadas son aquellas que provienen del Prototype (por ejemplo: length, toString), mientras que las no heredadas son propiedades que hemos definido nosotros.

const obj = {
   id:1,
   name: "gowtham",
   active: true
}

// Object.hasOwn no retorna las propiedades "inherited"
Object.hasOwn(obj, 'id'); // true
Object.hasOwn(obj, 'toString'); // false

// el operador "in" si retorna las propiedades "inherited"
'toString' in obj; // true


// Object.hasOwn también retorna las propiedades "non-enumerables".
const arr = new Array("secoya", "pino");

Object.hasOwn(arr, 'length'); // true

// una manera de comprobar si la propiedad es "enumerable"
arr.propertyIsEnumerable('length'); // false

// Esto retorna todas las propiedades enumerables y non-enumerables:
Object.getOwnPropertyNames(arr); // [ '0', '1', 'length' ]

• Utilizar Object.defineProperty:

Este método permite crear o sobreescribir una propiedad de un objeto. Al utilizarlo, las propiedades son por defecto no enumerables y no editables, pero ambas opciones pueden ser configuradas.

const createUser = (name) => {
  let user = {
    name: name
  }

  Object.defineProperty(user, 'id', {
    value: '1234',
    enumerable: true,
    writable: false // false is the default value, but define it here is more explicit
  });
  
  Object.defineProperty(user, 'privateValue', {
    enumerable: false,
    set: function () {
        throw new Error('Edit this property is not allowed');
    },
    get: function () {
        return '9857043';
    },
  });
  
  return user;
};

const john = createUser('John Doe');

for(const prop in john) {
  // the prop "privateValue" should not be iterated!
  console.log(john[prop])
}

john.privateValue; // '9857043' // you can access to the value directly


john.id = '67899'; // This is not working and not throws any error!!! It would throw in strict mode

john.privateValue = '67899'; // This throw our custom error

---

Namespaces:

Podemos agrupar funciones y valores en un namespace. Esto nos permite organizar mejor nuestro código. Existen diferentes máneras de obtener este resultado, una de ellas es usar namespaces.

• Namespaces con objetos literales:

const myApplication = {
	version: '1.0',
	name: 'my application',
	config: {
		url: '127.0.0.1',
		port: 3000
	},
	init: function() {
		// ....
	}
};

• Namespaces con IIFE (immediatly invoked function expression):

const myApplication = {};

(function(){
	let _protocol = 'https'; // esto es una variable "privada", no es accesible desde fuera del scope.

	this.version = '1.2',
	this.name = 'myApplication',
	this.config = {
		url: '127.0.0.1',
		port: 3000,
		protocol: _protocol
	},
	this.init = function() {
		//...
	}
}).apply(myApplication);

---

Closures:

• Podemos usar closures para organizar nuestro código. Un sencillo ejemplo con IIFE functions que nos permite crear un "módulo", una interesante alternativa a un namespace:

const geoModule = (function() {
	const _pi = 3.141592; // propiedad privada
	const _info = 'This is a module for doing geometrical calculations';

	const circleArea = (radius) => {
		if (!Number(radius)) throw new Error('You must provide a radius value');

		return _pi * radius * radius;
	};

	// definimos que métodos y que propiedades son accesibles públicamente
	return Object.freeze({
		calculateCircleArea: circleArea,
		information: _info
	})
})();

geoModule.calculateCircleArea(5); // 78.5398
geoModule.information; // 'This is a module for doing geometrical calculations'

---

Curry functions:

JavaScript es un lenguaje con "funciones de primera clase". Esto significa que el lenguaje soporta que tanto los argumentos como los valores de retorno puedan ser funciones.

Apoyándose en este concepto existen las "curry functions".

// Declaramos una curry function.
const concatenate = (foo) => (bar) => `${foo} ${bar}`;

// Ahora vamos a invocarla.
concatenate('hola')('mundo'); // 'hola mundo'
// Lo que ha ocurrido aquí es lo siguiente: 
// Primero se ejecuta el paréntesis de más a la izquierda. El valor 'hola' se asigna al parámetro foo y se retorna la siguiente función: (bar) => `${'hola'} ${bar}`;
// Luego se ejecuta el siguiente paréntesis, y el valor 'mundo' se asigna al parámentro bar. Por tanto se ejecuta esto: `${'hola'} ${'mundo'}`


// Para obtener otro ejemplo y que se entienda el concepto, vamos a invocar a la función nuevamente.
const myFunction = concatenate('saludos'); // (bar) => `${'saludos'} ${bar}`
// Fíjate que ha retornado una función, en la cual el parámetro foo ya ha sido asignado

myFunction('terricola'); // 'saludos terricola'
// Aquí se ha ejecutado la función que se había retornado previamente, y el argumento 'terricola' se asignó a la variable bar

Veamos un ejemplo de uso más realista (inyectar dependencias en un controlador de Express):

const { Router } = require('express');
const router = Router();

// Un servicio cualquiera:
const fooService = () => 'It works!';

// una curry function
const controllerFactory = ({ service }) => (req, res, next) => {
	try {
		const result = service(); // service esta disponible en el escope gracias a la curry function
		res.status(200).json({ data: result });
	} catch (e) {
		res.status(500).json({ error: e.message });
	}
};

// Preparamos las dependencias a inyectar
const injector = Object.freeze({
	service: fooService
});

// invocamos a la curry function pasándole las dependencias
router.get('/foo', controllerFactory(injector));

/*
	Observa que lo que conseguimos usando una curry function es inyectar una dependencia sin cambiar la firma de los parámetros del controlador. El controlador sigue recibiendo los 3 argumentos clásicos: req, res, next 
*/


/*
	Otra manera de inyectar servicios a un controlador de Express sin usar una curry function sería mediante un middleware que los añadiera al objeto "request".
*/

Otras maneras de generar curry functions:

/*
Otras maneras de generar curry functions.

Imagina que tienes una función llamada `foo` que recibe unos argumentos de una librería (por ejemplo, un middleware de Express o Vue-Router) externa.

En la función `foo` quieres inyectar algunas dependencias, pero no puedes alterar la librería externa. 

Una solución a este caso podría consistir en crear una función "inyectora" que a su vez retorne la función que va a usar la librería externa. La función inyectora sería la encargada también de inyectar todo aquello que sea necesario para la función `foo`
*/

const inject = (fn) => {
    const dataToInject = { // también podrías recibir esto como parámetro.
      someMethod: () => 'An injected method has been called'
    }
    return (...args) => fn(...args, dataToInject);
}

const foo = (value, dataToInject) => {
  console.log(value);
  console.log(dataToInject.someMethod().toUpperCase())
}

const fooWithInjection = inject(foo);

fooWithInjection('someValueFromExternalLibrary'); // la librería de terceros llamaría a nuestra función, pasándole los argumentos que correspondan. 
// La función `foo` recibe estos argumentos y además los inyectados.

---

Proxies:

El objeto Proxy se usa para definir un comportamiento personalizado para operaciones fundamentales (por ejemplo, para observar propiedades, cuando se asignan, enumeración, invocación de funciones, etc)

• Ejemplo de uso básico de proxies:

let product;

(function () {
    let _price = 0;

    product = {};

	// Podemos definir unos proxies para acceder a la propiedad 'price'.
	// Los proxies son muy útiles para hacer validaciones. Por ejemplo en el método 'set'. En este caso, estamos "interceptando" el acceso a la lectura y escritura de la propiedad 'price'.
    Object.defineProperty(product, 'price', {
        set: function (price) {
            _price = price;
        },

        get: function () {
            return _price;
        },
		enumerable: true
    });
})();

product.price = 100; // al hacer esto, accionamos el proxie 'set'

// En la siguiente linea accionamos el proxie 'get'
console.log(product.price); // 100

---

Set:

• Ejemplo básico de set:

const set = new Set([1, 2, 3, 4, 5]);
// Almacena valores únicos de cualquier tipo, incluso valores primitivos u objetos de referencia.
// Se forma a partir de un objeto iterable. Se puede crear vacío pasándole null.

set.has(4); // true
set.has('4'); // false. No se ha almacenado un string, si no un entero.

set.delete(5); // true

set.add('foo'); // {1, 2, 3, 4, "foo"}

const s = new Set([{a:1},{b:2},{a:1}]);
console.log(s); // {{a:1},{b:2},{a:1}}
// Observa que en este caso parece existir un objeto duplicado, en realidad son objetos distintos!

console.log(s.size); // 3

s.clear(); // Vacía de elementos el set

• Descomponer strings usando set (recuerda que no permite valores duplicados):

let mySet = new Set('foooooooooo');
// Esto sucede porque le estamos pasando un valor iterable (en este caso, un string)
console.log(mySet); // {"f", "o"}

for (let i of mySet) {
	console.log(i);
} // Una manera de iterar un set

mySet.forEach(i => console.log(i)); // Otra manera de iterar un set.
// Ojo, no funcionan: filter, map y reduce.
// Aunque puedes transformarlo en un array para usar estos métodos así: [...mySet]

• Eliminar elementos duplicados en un array mediante set y spread operator:

let nums = [1, 2, 2, 2, 2, 3, 4];
function deleteDuplicated(items) {
	return [ ... new Set(items) ]; // retorna un array
}
console.log( deleteDuplicated(nums) ); // [1, 2, 3, 4]

---

Map:

• Primeros pasos con map:

const biz = new Map();
biz.set('name', 'John');
biz.set('age', 53);

console.log(biz.size); // 2

for (let [key, value] of biz) {
	console.log(`${key} => ${value}`);
	// name => John
	// age => 53
}

console.log(biz.get('age')); // 53

biz.delete('age'); // true
console.log(biz); // {"name" => "John"}

biz.clear(); // {}

• Más opciones interesantes con map:

const biz = new Map( [ ['name','John'], ['Surname', 'Doe'], [undefined, null] ] );

console.log(biz.has('name')); // true
console.log(biz.has('Give me a cookie')); // false

console.log(biz); // {"name" => "John", "Surname" => "Doe", undefined => null}

const arrayOfKeys = Array.from(biz.keys()); // ["name", "Surname", undefined]

biz.forEach( (value, key, originalMap) => {
	if(value === null) {
		originalMap.delete(key);
	}
});
console.log(biz); // {"name" => "John", "Surname" => "Doe"}

biz.set('name', 'Maria'); // {"name" => "Maria", "Surname" => "Doe"}

---

Debugging y console:

• Uso del comando debugger (establece un "breakpoint" en el código):

// some code...
debugger;
// some code...

• La propiedad table del objeto console (retorna una tabla a partir de un objeto o un array)

var person = { firstName:"John", lastName:"Doe", age:50 };
console.table(person);

• Destructuring en el console.log

let person = { firstName:"John", lastName:"Doe", age:34 };
console.log( { person } );

• Uso de console.group() / console.groupEnd() en bucles:

for(var i = 0; i < 2; i++){
	console.group("Primer nivel: ", i);

	for(var k = 0; k < 2; k++){
		console.group("Segundo nivel: ", k);
		
		// Your code...
		console.log("Value of i: " + i);
		console.log("Value of k: " + k);

		console.groupEnd();
	}

	console.groupEnd();
}

• Uso de console.trace() para ver el stack:

function foo() {
	function biz(txt) {
		console.trace(txt)
	}
	biz('example');
}
foo();

// 'example'
// biz @...
// foo @...

• Uso de console.log con estilos CSS:

var foo = "AWESOME";
console.log('%c' + foo, 'color: yellow; background-color: black;');

• Uso de console.time() para medir tiempos de ejecución:

console.time('Timer A');

for (let i = 0; i < 999999; i++) {
	// Para obtener una medición fiable, quizás necesites usar un bucle para maximizar los resultados
}

console.timeLog('Timer A');

let i = 0
while (i < 999999) {
	i++;
}

console.timeEnd('Timer A');

// Timer A: 4.47607421875ms
// Timer A: 9.0048828125ms

• Un pequeño truco para saber con que tipo (primitivo o no) trabajamos:

function whatTypeIs (type){
	return Object.prototype.toString.call(type).slice(8,-1);
}

console.log( whatTypeIs( ["A", "B"] ) ); // "Array"
console.log( whatTypeIs( {} ) ); // "Object"
console.log( whatTypeIs( "foo" ) ); // "String"
console.log( whatTypeIs( 4 ) ); // "Number"
console.log( whatTypeIs( /[a]/g ) ); // "RegExp"
console.log( whatTypeIs( new Set() ) ); // "Set"
console.log( whatTypeIs( new Map() ) ); // "Map"
console.log( whatTypeIs( () => {} ) ); // "Function"
console.log( whatTypeIs( null ) ); // "Null"
console.log( whatTypeIs( undefined ) ); // "Undefined"
console.log( whatTypeIs( NaN ) ); // "Number"
console.log( whatTypeIs( new Date ) ); // "Date"
console.log( whatTypeIs( Promise.resolve() ) ); // "Promise"

• JSON.stringify fáciles de leer. Puedes usar el tercer parámetro para espicificar el tipo de indentación:

const person = { firstName:"John", lastName:"Doe", age:34 };

JSON.stringify(person, null, 2); // Indentación: dos espacios
/*
{
  "firstName": "John",
  "lastName": "Doe",
  "age": 34
}
*/


JSON.stringify(person, null, '\t'); // Indentación: tabulador
/*
{
	"firstName": "John",
	"lastName": "Doe",
	"age": 34
}
*/

• Revisar el código de una función:

function someFunction(){
	// ...
};
console.log( someFunction.toString() );

• Utiliza esto en la consola del navegador para debuggear el CSS:

$$('*').forEach((el) => el.style.border = '1px solid red');

---

De callback hell a promesas:

function justAnAsyncFunction(str, cb) {
	// Esto sólo simula ser algo asíncrono
	setTimeout(function(){
		if(!str) {
			cb({ok: false});
		} else {
			cb ({
				ok: true, 
				users: ['john', 'jack']
			});
		}
	}, 2000);
}


function retrieveUsers(cb) {
	// tipico ejemplo de anidación de funciones que contienen callback (callback hell)
	justAnAsyncFunction('SELECT * FROM users', function(results) {
		if (results.ok) {
			cb(results.users);
		} else {
			cb('Error');
		}
	});
}

retrieveUsers(console.log); // retorna ["john", "jack"] al cabo de dos segundos.


// Ahora fíjate como reescribiendo la función "retrieveUsers" se convierte en una promesa
function retrieveUsers_promisify() {
	return new Promise( (resolve, reject) => {
		justAnAsyncFunction('SELECT * FROM users', function(results) {
			if (results.ok) {
				resolve( results.users );
			} else {
				reject( new Error('Error') );
			}
		});
	});
}

// Esto nos permite llamarla e interactuar con ella como promesa!
function getUserUsingPromises(cb) {
	return retrieveUsers_promisify()
	.then((results) => {
		cb(results);
	})
	.catch((error) => {
		console.error(error.message);
	});
}

getUserUsingPromises(console.log); // esto es una promesa que tardará dos segundos en resolverse y dará este resultado: ["john", "jack"]

console.log(await retrieveUsers_promisify()); // También puedo hacer esto! Ojo, aquí estoy deteniendo la ejecución hasta que el código asíncrono acabe de ejecutarse

---

Promesas:

• Ejemplo de una cadena de promesas en la que la primera provee los datos para que la segunda puedan ejecutarse:

const runAsyncFunctions = async () => {
  const users = await getUsers(); // Esto retornaría un array

  Promise.all(
	users.map(async user => {
	  const userId = await getIdFromUser(user);

	  const capitalizedId = await capitalizeIds(userId);
	})
  );
}

runAsyncFunctions(); // esto es una promesa

---

Async-Await:

Recuerda que async crea una promesa.

• Uso de async-await:

// Ejemplo 1:
async function cooking() {
	const a = await obtainIngredientA();
	const b = await obtainIngredientB();
	const recipe = await newRecipe(a,b);
	return recipe;
} // async convierte esta función en una promesa

cooking().then((result) => {
	console.log(result);
}).catch((e) => {
	// if 'cooking' function or 'then' method throw an error...
	console.error(e.message);
});


// Ejemplo 2:
const getIngredients = async () => {
	try {
		const butter = await getButter();
		const flour = await getFlour();
		const sugar = await getSugar();
		const eggs = await getEggs();
		return [
			butter,
			flour,
			sugar,
			eggs,
		];
	} catch(e) { 
		return e; 
	}
}

getIngredients().then((result) => {
	if (result instanceof Error) {
		// if 'getIngredients' function throw an error...
		console.error(result.message);
	}
	// ...
}).catch((e) => {
	// if 'then' method throw an error...
	console.error(e.message);
});


// Ejemplo 3:
const to = (promise) => {
	return promise.then((data) => [null, data]).catch((err) => [err]);
};

async function getDataFromAsyncCode() {
	const [err, response] = await to(justAnAsyncFunction());
	if (err) throw new Error(`Error: ${err}`);
	return response;
}

getDataFromAsyncCode(); // Esto es una promesa. Debes tratar los resultados con 'then()' y 'catch()';

// También puedes hacer esto:
console.log(await getDataFromAsyncCode()); // Ojo, estas deteniendo la ejecución del código


// Ejemplo 4:
// Traditional promise chaining
getIssue()
	.then(issue => getOwner(issue.ownerId))
	.then(owner => sendEmail(owner.email, 'Some text'));

// Using async functions! (Considera agruparlo bajo una función async si no quieres detener la ejecución del script)
const issue = await getIssue();
const owner = await getOwner(issue.ownerId);
await sendEmail(owner.email, 'Some text');


// Ejemplo 5:
async function foo(things) {
	const listOfpromises = [];
	for (let thing of things) { // use "for ... of" in arrays or sets; use "for ... in" in objects
		// good: all asynchronous operations are inmediately started
		listOfpromises.push( asyncFooFunction(thing) );
	}

	// now that all the asynchronous operations are running, here we wait until they all complete
	return await Promise.all(listOfpromises);
}


// Ejemplo 6 (llamadas asíncronas en paralelo):
async function parallelApiCalls() {
	const [firstResult, secondResult] = await Promise.all([fetchFirst(), fetchSecond()]); // si una falla, no se espera a que complete el resto
	return [firstResult, secondResult];
}

• Averiguar si una función es asíncrona (async):

const isAsync = fooFunction.constructor.name === "AsyncFunction";

---

setTimeout:

• Truco para ejecutar un código al momento y repetir su ejecución de manera periódica:

(function loop() {
	// ... Your code!

	setTimeout(loop, 2000);
})();

// También puedes hacer esto:
(async function loop() {
	// ... Your code!
	await foo();

	setTimeout(loop, 2000);
})();

---

setInterval:

• Asegurarse de que solo un intérvalo está ejecutandose:

let interval = null;

function setClock() {
	if (!interval) { // This prevent more than one callback at a time!!
		const TEN_SECONDS = 10000;
		interval = setInterval(() => {
			console.log('hola')
		}, TEN_SECONDS);
	}
}

setClock(); // start the interval
setClock(); // this second call does not set a second interval


// The correct way to stop the interval
function unsetClock() {
	clearInterval(interval);
	interval = null;
}

unsetClock()

---

DOM:

• Trabajando con el DOM:

// selectores:
document.querySelector('.foo'); // obtener el primer elemento dentro del documento que coincida con el selector
document.querySelectorAll('.foo'); // Obtener una lista de elementos

// otros selectores:
const biz = document.querySelector('.biz');
const children = biz.childNodes; // obtener los hijos de un nodo
const parent = biz.parentNode; // obtener el padre de un nodo

biz.classList.add('.is-active'); // añadir una clase a un elemento
biz.classList.remove('.hidden'); // quitar una clase a un elemento
biz.classList.toggle('.dark-mode'); // alternar una clase a un elemento
biz.classList.contains('.black-text'); // comprobar si un elemento tienen una clase

// crear un elemento e insertarlo en el DOM
const newChildElement = document.createElement('p');
const newChildElement.innerText = 'Example!';
biz.appendChild(newChildElement);

// eliminar un nodo del DOM
biz.remove();

---

ECMAScript modules vs CommonJS modules on Node.js

• A partir de Node.js 14 puedes usar los ECMAScript modules. Por defecto, los ficheros se comportan como en 'strict mode;'.

---

unhandledRejection on Node.js

• Manera de capturar globalmente los errores de tipo unhandledRejection.

import process from 'process';

Promise.reject(new Error('patata')); // you should always return "new Error" when reject a promise

process.on('unhandledRejection', (reason, promise) => {
	const error = {
		error: reason,
		message: reason instanceof Error ? reason.message : reason,
		stack: reason instanceof Error ? reason.stack : null,
		promise
	};

	console.error(error);
});

---

Fetch

Fetch está disponible a partir de Node.js 18. Además, tiene soporte para todos los navegadores modernos.

Esto es un ejemplo sencillo:

try {
	const res = await fetch('https://nodejs.org/api/documentation.json');
	if (!res.ok) {
		throw new Error(`Fetch response was not OK: ${response.status} ${response.statusText}`);
	}

	const data = await res.json();
	console.log(data);
} catch(error) {
	// a network error is encountered or CORS is misconfigured on the server-side
	console.error(error)
}

Un ejemplo más completo:

async function fetchPOST(url, data = {}) {
	try {
		const options = {
			// Default options are marked with *

			method: 'POST', // *GET, POST, PUT, DELETE, etc.
			//mode: 'cors', // no-cors, *cors, same-origin
			//cache: 'no-cache', // *default, no-cache, reload, force-cache, only-if-cached
			//credentials: 'same-origin', // include, *same-origin, omit
			headers: {
				'Content-Type': 'application/json',
				// or...
				// 'Content-Type': 'application/x-www-form-urlencoded',
				// 'Content-Type': 'multipart/form-data',
				// 'Content-Type': 'text/plain',
			},
			//redirect: 'follow', // manual, *follow, error
			//referrerPolicy: 'no-referrer', // no-referrer, *no-referrer-when-downgrade, origin, origin-when-cross-origin, same-origin, strict-origin, strict-origin-when-cross-origin, unsafe-url
			body: JSON.stringify(data), // body data type must match 'Content-Type' header
		};

		const response = await fetch(url, options);

		const contentType = response.headers.get('content-type');

		if (!contentType || !contentType.includes('application/json')) {
			throw new TypeError('Fetch response is not a JSON');
		}

		if (!response.ok) {
			throw new Error(`Fetch response was not OK: ${response.status} ${response.statusText}`);
		}

		return await res.json();
	
	} catch (error) {
		// a network error is encountered or CORS is misconfigured on the server-side
		console.error(error);
	}
}

fetchPOST('https://api.example.com', { foo: 'foo' });

Puedes construir objetos de tipo Headers, URLSearchParams y Request de esta forma:

async function fetchAPI(request) {
	try {
		const response = await fetch(request);
		// ...
	} catch(error) {
		// ...
	}
}

const myHeaders = new Headers({
	'Content-Type': 'application/json',
});

myHeaders.append('X-Custom-Header', 'ProcessThisImmediately');

const params = new URLSearchParams();
params.append('name', 'John Doe');

const myRequest = new Request(`https://api.example.com/users?${params.toString()}`, {
	method: 'GET',
	credentials: 'omit',
	headers: myHeaders,
	mode: 'cors',
	cache: 'no-cache',
});

fetchAPI(myRequest);

---

Switch vs mapper

• Algunas veces es mejor usar un mapper que un switch. Observa esta implementación alternativa a un switch.

// usando switch:
function getPriceOfDrink(drink) {
  const commonPrice = 2;
  let tax;
  switch(drink) {
  case 'coke':
    tax = 0.3;
    break;
  case 'pepsi':
    tax = 0.2;
    break;
  default:
    tax = 0;
  }

  return commonPrice + tax
}

getPriceOfDrink('coke'); // 2.3


// usando un mapper:
function getPriceOfDrink(drink) {
  const commonPrice = 2;
  const TAXES = {
    'coke': 0.3,
    'pepsi': 0.2
  };
  const DEFAULT_TAX = 0;

  const tax = TAXES[drink] || DEFAULT_TAX;
  return commonPrice + tax;
}

getPriceOfDrink('coke'); // 2.3

---

API Intl

Esta API provee un conjunto de métodos para trabajar con cadenas de texto, números, fechas, usos horarios y tiempos con sensibilidad al lenguaje.

• Intl.ListFormat

const fruits = ['banana', 'apple', 'watermelon', 'orange'];

new Intl.ListFormat('en', { style: 'short', type: 'conjunction' }).format(fruits); // 'banana, apple, watermelon, & orange'

new Intl.ListFormat('en', { style: 'long', type: 'conjunction' }).format(fruits); // 'banana, apple, watermelon, and orange'

new Intl.ListFormat('en', { type: 'disjunction' }).format(fruits); // 'banana, apple, watermelon, or orange'

• Intl.NumberFormat

const number = 123456.789;

new Intl.NumberFormat('es-ES', { style: 'currency', currency: 'EUR' }).format(number); // '123.456,79 €'
new Intl.NumberFormat('es-ES', { style: 'currency', currency: 'EUR', maximumFractionDigits: 0 }).format(number); // '123.457 €'

• Intl.DateTimeFormat

const date = new Date(Date.UTC(2020, 11, 20, 3, 23, 16));

new Intl.DateTimeFormat('en-GB', { dateStyle: 'full', timeStyle: 'long' }).format(date); // 'Sunday, 20 December 2020 at 04:23:16 CET'

• Intl.RelativeTimeFormat

new Intl.RelativeTimeFormat('es', { numeric: 'auto' }).format(2, 'day'); // 'pasado mañana'

new Intl.RelativeTimeFormat('es', { numeric: 'always' }).format(2, 'day'); // 'dentro de 2 días'

new Intl.RelativeTimeFormat('es', { numeric: 'auto' }).format(-1, 'day'); // 'ayer'

new Intl.RelativeTimeFormat('en', { numeric: 'auto' }).format(-2, 'hour'); // '2 hours ago'

• Intl.RelativeTimeFormat. Otro ejemplo muy útil:

const DATE_UNITS = {
	year: 31536000,
	month: 2592000,
	day: 86400,
	hour: 3600,
	minute: 60,
	second: 1
};

const getSecondsDiff = (timestamp) => (Date.now() - timestamp) / 1000;

const getUnitAndValueDate = (secondsElapsed) => {
	for (const [unit, secondsInUnit] of Object.entries(DATE_UNITS)) {
		if (secondsElapsed >= secondsInUnit || unit === "second") {
			const value = Math.floor(secondsElapsed / secondsInUnit) * -1;
			return { value, unit }
		}
	}
};

const getTimeAgo = (timestamp, locale = 'en-UK') => {
	const rtf = new Intl.RelativeTimeFormat(locale, {
		numeric: 'auto',
		style: 'long',
	});

	const secondsElapsed = getSecondsDiff(timestamp);

	const { value, unit } = getUnitAndValueDate(secondsElapsed) || {};

	if (value === undefined || unit === undefined) {
		throw new RangeError('Invalid value at getTimeAgo function');
	}

	return rtf.format(value, unit);
};


// Algunos ejemplos de uso:
const threeHoursAgoDate = Date.now() - (3 * 60 * 60 * 1000)
console.log(getTimeAgo(threeHoursAgoDate)) // '3 hours ago'

const yesterdayDate = Date.now() - (1 * 24 * 60 * 60 * 1000)
console.log(getTimeAgo(yesterdayDate)) // 'yesterday'

const twoDaysAgoDate = Date.now() - (2 * 24 * 60 * 60 * 1000)
console.log(getTimeAgo(twoDaysAgoDate)) // '2 days ago'

console.log(getTimeAgo(Date.now())) // now

const twoMonthsAgo = Date.now() - (60 * 24 * 60 * 60 * 1000)
console.log(getTimeAgo(twoMonthsAgo)) // '2 months ago'

const threeYearsAgo = Date.now() - (1095 * 24 * 60 * 60 * 1000)
console.log(getTimeAgo(threeYearsAgo)) // '3 years ago'

• Obtener información sobre una determinada región:

const spanishFromSpainLocale = new Intl.Locale('es-ES');

spanishFromSpainLocale.timeZones; // [ 'Africa/Ceuta', 'Atlantic/Canary', 'Europe/Madrid' ]
spanishFromSpainLocale.weekInfo; // { firstDay: 1, weekend: [ 6, 7 ], minimalDays: 4 }

• Ver todas las opciones disponibles:

Intl.supportedValuesOf('currency'); // return the list of supported currencies (EUR, CHF, etc..)
Intl.supportedValuesOf('timeZone'); // return the list of supported time zones ('Africa/Ceuta', 'Atlantic/Canary', 'Europe/Madrid', etc...)
Intl.supportedValuesOf('unit'); // return the list of supported units (meter, second, celsius, byte, etc..)

---

Navigator Interface

• Navigator.sendBeacon()

Este método permite hacer una llamada HTTP asíncrona de tipo POST. Esta especialmente diseñado para enviar datos analíticos al servidor.

function analytics(eventCategory, eventValue) {
	// eventCategory examples: 'form', 'click', 'navigation', 'error', 'filter', 'search' ...
	// eventValue examples: 'register form', 'on button CTA', 'page /about', 'password validation', ... 
	if (!navigator.sendBeacon) {
		return;
	};

	const dataToSend = new FormData();
	dataToSend.append('datetime', new Date().toISOString());
	dataToSend.append('location', window.location.toString());
	dataToSend.append('pathname', window.location.pathname);
	dataToSend.append('eventCategory', eventCategory);
	dataToSend.append('eventValue', eventValue);

	const URL = 'https://example.com/analytics';
	navigator.sendBeacon(URL, dataToSend);
}

analytics('form', 'saveNewUserData');
analytics('click', 'adBanner');

---

Debounce

• El debounce es una estrategia que nos permite mejorar el rendimiento esperando a que transcurra un cierto tiempo antes de lanzar un evento.

const debounce = (callback, delay = 300) => {
	let timeoutId = null;

	return (...args) => {
		clearTimeout(timeoutId);

		timeoutId = setTimeout(() => {
			callback.apply(this, args);
		}, delay);
	};
};


// Ejemplo de utilización:
const delay = 250;

const handleMouseMove = debounce((event) => {
	// Do stuff with the event!
}, delay);

window.addEventListener('mousemove', handleMouseMove);

---