promise-ax

    2.0.53 • Public • Published

    Promise Ax o promise-ax

    Promise Ax or promise-ax (Promesa) es usado para computaciones asíncronas. Una promesa representa un valor que puede estar disponible ahora, en el futuro, o nunca.

    100% compatible con Promise.

    Funciones

    • allSettledWithTimeOut: A diferencia de allSettled, allSettledWithTimeOut permite definir la promesa, tiempo de espera, y mensaje de error. Cada promesa o función asíncrona es ejecutada por separado y en paralelo con su tiempo de espera definido.

      Sintaxis

      Promise.allSettledWithTimeOut(iterable, timeout, messageTimeOut);

      Atributo Tipo Requerido Descripción
      iterable Array SI Un objeto iterable
      timeout Number SI Tiempo de espera en milisegundos, por ejemplo 2000, que corresponde a 2 segundos
      messageTimeOut String NO Mensaje de error en el caso que se vence el tiempo de espera. Mensaje por defecto: Timeout is not defined

      Valor devuelto

      Un Promise que se cumplirá de forma asincrónica una vez que se hayan completado todas las promesas de la colección especificada de promesas, ya sea al cumplirse con éxito o al ser rechazadas.

    • allSettled: Devuelve una promesa que se resuelve después de que todas las promesas dadas se hayan cumplido o rechazado, con una serie de objetos que describen el resultado de cada promesa.

      Sintaxis

      Promise.allSettled(iterable);

      Atributo Tipo Requerido Descripción
      iterable Array SI Un objeto iterable

      Valor devuelto

      Un Promise que se cumplirá de forma asincrónica una vez que se hayan completado todas las promesas de la colección especificada de promesas, ya sea al cumplirse con éxito o al ser rechazadas.

    • all: Devuelve una promesa que termina correctamente cuando todas las promesas en el argumento iterable han sido concluídas con éxito, o bien rechaza la petición con el motivo pasado por la primera promesa que es rechazada.

      Sintaxis

      Promise.all(iterable);

      Atributo Tipo Descripción
      iterable Array Un objeto iterable

      Valor devuelto

      Una Promise que se cumplirá cuando todas las promesas del argumento iterable hayan sido cumplidas, o bien se rechazará cuando alguna de ellas se rechace.

    • race: Retorna una promesa que se cumplirá o no tan pronto como una de las promesas del argumento iterable se cumpla o se rechace, con el valor o razón de rechazo de ésta.

      Sintaxis

      Promise.race(iterable);

      Atributo Tipo Descripción
      iterable Array Un objeto iterable

      Valor devuelto

      Una Promise que se cumple o se rechaza tan pronto como una de las promesas dadas en el argumento iterable se cumple o se rechaza.

    • reject: Retorna un objeto Promise que es rechazado por la razón específicada.

      Sintaxis

      Promise.reject(reason);

      Atributo Tipo Descripción
      reason Object Un objeto para rechazar

      Valor devuelto

      Razón por la cual esta {jsxref("Promise")}} fue rechazada.

    • resolve: Retorna un objeto Promise que es resuelto con el valor dado. Si el valor es una promise, esa promise es devuelta; si el valor es un thenable (si tiene un método "then"), el valor devuelto le seguirá a ese thenable, adoptando su estado; de otro modo la promise devuelta estará completada con el valor.

      Sintaxis

      Promise.resolve(value);

      Atributo Tipo Descripción
      value Object Argumento por resolver por esta Promise. También puede ser una Promise o un thenable por resolver.

      Valor devuelto

      Una Promise que es resuelta con el valor dado, o con la promise pasada como valor, si el valor era un objeto promise.

    Nuevas Características y/o cambios

    • Se aumentan los casos de pruebas.
    • Se agregan palabras claves para los filtros de búsquedas.
    • Se eliminan dependencias innecesarias.

    Instalación

    Se requiere tener instalado Node.js v7+ para ejecutar.

    npm install --save-dev promise-ax

    Ejemplos

    // Ejemplo #1: Uso de promesa del sistema en combinación con Promise-Ax
    const { createPromise } = require('promise-ax');
    const promiseAx = createPromise();
    const promise1 = Promise.resolve(4);
    const promise2 = new Promise((resolve, reject) => setTimeout(reject, 100, new Error("error")));
    const promise3 = Promise.reject("error");
    const promise4 = promiseAx.resolve(8);
    const promise5 = promiseAx.reject("errorAx");
    const asyncOperation = (time) => {
        return new Promise((resolve, reject) => {
            if (time < 0) {
                reject("reject");
            }
            setTimeout(() => {
                resolve(time);
            }, time);
        });
    };
    const promisesToMake = [promise1, promise2, promise3, promise4, promise5, asyncOperation(100)];
    promiseAx.allSettled(promisesToMake).then((results) => results.forEach((result) => console.log(result)));
    // Salida esperada:
    // 4
    // Error: error
    // error
    // 8
    // errorAx
    // 100
    // Ejemplo #2: Ejecutar promesas en paralelos con tiempo de espera con mensaje de error.
    const { createPromise } = require('promise-ax');
    const promiseAx = createPromise();
    const asyncOperation = (time) => {
        return new Promise((resolve, reject) => {
            if (time < 0) {
                reject("reject");
            }
            setTimeout(() => {
                resolve(time);
            }, time);
        });
    };
    const promisesToMake = [asyncOperation(1000), asyncOperation(2000)];
    promiseAx.allSettledWithTimeOut(promisesToMake, 1500, "Tiempo de espera vencido").then((results) => results.forEach((result) => console.log(result)));
    // Salida esperada:
    // 1000
    // Error: Tiempo de espera vencido
    // Ejemplo #3: Ejecutar promesas en paralelos con tiempo de espera sin mensaje de error.
    const { createPromise } = require('promise-ax');
    const promiseAx = createPromise();
    const asyncOperation = (time) => {
        return new Promise((resolve, reject) => {
            if (time < 0) {
                reject("reject");
            }
            setTimeout(() => {
                resolve(time);
            }, time);
        });
    };
    const promisesToMake = [asyncOperation(1000), asyncOperation(2000)];
    promiseAx.allSettledWithTimeOut(promisesToMake, 1500).then((results) => results.forEach((result) => console.log(result)));
    // Salida esperada:
    // 1000
    // Error: Timeout is not defined

    Pruebas

    Ejecutar el comando:

    npm test --maxWorkers=4

    License

    MIT

    Otros

    Siempre gratis, siempre libre

    Install

    npm i promise-ax

    DownloadsWeekly Downloads

    7

    Version

    2.0.53

    License

    MIT

    Unpacked Size

    19.7 kB

    Total Files

    9

    Last publish

    Collaborators

    • josmejia.2401