codigos-utiles-ap | Mi primer módulo de JavaScript subido a npm

Bienvenido! Este proyecto nació bajo el deseo de guardar y publicar en npm algunas de las funciones de JavaScript y Typescript que ocasionalmente creo por necesidad en otros proyectos. La idea es ir agrandando este módulo cada vez más con el paso del tiempo, con el propósito de ayudarme tanto a mí como a otros programadores de ser posible.

Revisa la documentación regularmente aquí para chequear que utilizas la última versión.

Instalación y uso 🔧

• En la terminal, escribe

npm install codigos-utiles-ap

Importa el módulo con el nombre que más te guste antes de utilizarlo, por ejemplo:

import codigosap from "codigos-utiles-ap"

Desde este momento, codigosap es un objeto que contiene como métodos a todas las funciones descritas en la sección Funciones.

Por ejemplo, si queremos obtener 3 elementos al azar del array [-50, 0, -3, "40", "josé", true, ["Kilo", 3]], simplemente escribimos:

const elementos = codigosap.obtenerNElementos([-50, 0, -3, "40", "josé", true, ["Kilo", 3]], 3)

Alternativamente puedes importar las funciones usando desestructuración:

import { obtenerNElementos } from "codigos-utiles-ap"

const elementos = obtenerNElementos([-50, 0, -3, "40", "josé", true, ["Kilo", 3]], 3)

• Si lo deseas, puedes instalar el módulo adhiriendo el siguiente link a tu archivo HTML:

<script src="https://cdn.jsdelivr.net/npm/codigos-utiles-ap/dist/index_CDN.min.js"></script>

No recomiendo esta última opción ya que no contiene sugerencias de autocompletado ni documentación.

Funciones 🤓

Aquí presento todas las funciones actuales del módulo, que pueden ser llamados tal como se describió anteriormente.

Consejo: En tu editor de código favorito pasa el mouse sobre ellas para obtener una breve explicación que te diga cómo deben ser usadas!

Funciones que involucran números

• probabilidadDeN(n) Recibe un número n entre 0 y 100. Devuelve true el n% de las veces.

• numeroAlAzar(num1, num2) Recibe dos números num1 y num2 donde num1 <= num2. Devuelve un número al azar entre ellos (no incluye al num2).

• numeroEnteroAlAzar(num1, num2) Recibe dos números enteros y devuelve un número entero al azar entre ellos (incluyendo a ambos números).

• esDivisor(num1, num2) Recibe dos números. Si num2 es divisor de num1 entonces devuelve true (es decir, si num1/num2 tiene resto cero).

• divisores(num) Recibe un número entero y devuelve un array con todos sus divisores.

• factoresMasCercanos(n) Recibe un número natural n y devuelve un array con dos valores [a, b] tal que n=a*b, donde a y b son los valores más cercanos posibles.

• redondear(n) Recibe un número y lo devuelve redondeado a dos decimales.

• factorial(n) Recibe un número natural o cero. Devuelve el factorial de dicho número.

• esPar(n) Recibe un número. Devuelve true si es par, pero false si es impar.

Funciones que involucran arrays

• elementoAlAzar(array) Recibe un array y retorna un elemento al azar.

• mezclarArray(array) Recibe un array y lo devuelve mezclado.

• obtenerNElementos(array, n) Recibe un array y un número natural n. Devuelve n elementos al azar del array.

• arange(origen, final, espaciado = 1) Recibe tres números. El tercero es opcional pero debe ser positivo. Devuelve un array de números equiespaciados desde el origen hasta el final (sin incluir) solicitado, considerando el espaciado especificado.

• linspace(origen, final, densidad) Recibe tres números. Los primeros dos deben ser distintos. El tercero debe ser positivo. Devuelve un array de números equiespaciados desde el origen hasta el final solicitado, considrando la densidad (cantidad) de valores especificados.

• ubicacionNElementosMasGrandes(array, n) Recibe un array de números y un número natural n. Devuelve un array de números enteros con las posiciones de los n elementos más grandes del array original, o más si hay un empate en los últimos puestos.

Funciones que involucran strings

• stringAleatorio(n) Recibe un número n natural, devuelve un string con carácteres aleatorios de longitud n.

• superTrim(string) Recibe un string, devuelve el mismo string sin espacios en blanco en ambos extremos y reemplaza todos los espacios consecutivos por uno solo.

• tieneMayuscula(string) Recibe un string. Devuelve true si contiene alguna mayúscula, sin importar el idioma de escritura de la letra.

• tieneCaracterEspecial(string) Recibe un string. Devuelve true si tiene algún carácter de puntuación, símbolo, marcador, control o caracter de formato (no se consideran los espacios en blanco).

• tieneNumero(string) Recibe un string. Devuelve true si el string tiene algún número y false en caso contrario.

Funciones que involucran objetos

• crearObjeto(claves, valores) Recibe dos arrays A y B, retorna un objeto cuyas claves son los elementos de A y los valores son los elementos de B.

• esObjetoLiteral(param) Recibe un elemento de cualquier tipo. Devuelve true si es un objeto literal y false en caso contrario.

Extras

• colorRandom() Retorna un color RGB al azar

• waitFor(time) Hace que tu código asincrónico espere un tiempo (en milisegundos) que le pases como parámetro antes de continuar la ejecución.

Estoy abierto a sugerencias!

Construido con 🛠️

• JavaScript
• Typescript
• NodeJs

Autor ✒️

• Alejandro Portaluppi - LinkedIn