npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

taimy

v1.0.1

Published

Taimy es una clase que ejecuta funciones dentro de un período de tiempo específico de manera más simple.

Downloads

10

Readme

Taimy

Taimy es una clase que ejecuta funciones dentro de un período de tiempo específico de manera más sencilla.
ver demo

instalacion:
npm i taimy

¿Qué soluciona Taimy?

Si bien setInterval y setTimeOut hacen lo mismo que Taimy, algunas diferencias son:

  1. La comodidad de destruir el hilo de ejecución ya sea de manera automática: especificando una duración, de forma manual usando los métodos detener() y/o destructor(), incluso al iniciar un nuevo hilo.
  2. La habilidad de detener y reanudar el hilo de ejecución a placer.
  3. La posibilidad de cambiar los parámetros de duracion, intervalo, tiempo de espera y la función en tiempo de ejecución.
  4. La seguridad de evitar interval memory leak en la mayor parte de lo posible, reejecuciones y uso indiscriminado de múltiples hilos.

Documentación

Constructor

-- (opcional) --

const instanciaTaimy = new Taimy(fn, dataTiempo);
  • fn: (opcional) Función a ejecutarse, puede aceptar un cronometro como parámetro: cronometro => { código }
  • dataTiempo: (opcional) Objeto {espera, duracion, intervalo} debe contener como mínimo la propiedad: intervalo o espera todas estas variables aceptan valores numéricos expresados en milisegundos.

Nuevo

const instanciaTaimy = new Taimy;
instanciaTaimy.nuevo(fn,dataTiempo);

Exactamente lo mismo que el constructor solo que aquí es de forma obligatoria.

tener en cuenta que si existe un hilo de ejecución corriendo este será eliminado.

Configuración

const instanciaTaimy = new Taimy;
instanciaTaimy.funcion = function(cronometro){
    /*código*/
    };
instanciaTaimy.duracion = 50000; // milisegundos
instanciaTaimy.cambiarDuracion(50000); // milisegundos

instanciaTaimy.intervalo = 3000; // milisegundos
instanciaTaimy.cambiarIntervalo(3000); // milisegundos

instanciaTaimy.espera = 100; // milisegundos
instanciaTaimy.cambiarEspera(100); // milisegundos

Si se encuentra en ejecución los cambios se verán reflejados al instante sin nesecidad de volver a arrancar Taimy.

  • funcion : La función que se pretende ejecutar, esta puede recibir un parámetro cronómetro que contiene el tiempo transcurrido en milisegundos.

  • duracion / cambiarDuracion : la duración puede ser finita al darle un valor numérico o infinita al signarle undefined.

  • intervalo / cambiarIntervalo : Lapso de tiempo en que se estará ejecutando la función repetidamente.

  • espera / cambiarEspera : Tiempo que esperará para comenzar a ejecutarse.

Arranque y Pausa/Detener

instanciaTaimy.arrancar(); // comienza la ejecución
instanciaTaimy.detener(); // detiene/pausa la ejecución
document.addEventListener('click',instanciaTaimy.interruptor); // detiene/pausa o reanuda la ejecución
  • arrancar : Da la orden de comenzar o reanudar la ejecución.
  • detener : Detiene o pausa "segun como desee verlo" la ejecución para despues ser reanudado.
  • interruptor : alterna entre arrancar y detener dependiendo de el estado de ejecución en que se encuentre.

Reinicio y Destrucción

instanciaTaimy.reiniciar();
instanciaTaimy.reinicioTotal();
instanciaTaimy.destructor();
  • reiniciar : Reinicia la ejecución desde el comienzo

  • reinicioTotal : Reinicia la ejecución apartir desde el tiempo de espera

  • destructor : Detiene la ejecución en curso y formatea el contenido interno de la instanacia para dejarla vacía.

Cabe mencionar que los métodos de reiniciar y reinicioTotal reinician el propio hilo de ejecución no la funcion otorgada por lo que si desea que su funcion también sea reiniciada puede usar el valor de inicio del cronómetro como referencia ya que este siempre al inicio es 0

// ejemplo
instanciaTaimy.funcion = function (cronometro){ 
    if(!cronometro)
        {/*código de reinicio*/}
    /*código*/}

instanciaTaimy.reiniciar();

Funciones extras

const objetoTiempo = TaimyForm(123456789); //milisegundos
const reloj = TaimyReloj(objetoTiempo) //objeto {d,h,m,s,ms}
console.log(objetoTiempo);
console.log(reloj);
terminal:
> Object { d: 1, h: 11, m: 36, s: 23, ms: 573 }
    d: 1
    h: 11
    m: 36
    ms: 573
    s: 23
​   > <prototype>: Object { … }

01:11:36:23:57

TaimyForm( ms ) :

  • Función que admite milisegundos
  • Retorna un objeto {d,h,m,s,ms} d = días, h = horas, m = minutos, s = segundos, ms = milisegundos.

TaimyReloj( objetoTiempo , formato , limite) :

  • objetoTiempo -> {d,h,m,s,ms}
  • formato -> {string} (opcional) que indica la forma y orden en que se va mostrar el reloj como mínimo debe espesificar 2 elementos válidos y máximo 5.
    < ejemplo > :
    Si solo se quiere mostrar la hora, minuto y segundo "h/m/s" el resultado sería 11:36:23
    Para mostrar los milisegundos,minutos,días "sm/m/d", resultado: 57:36:01.
  • limite -> {number} (si formato no está definido este automáticamente se ignora) define los límites de como se muestra el string reloj:
    limite = 0 : El reloj irá creciendo como sea necesario ejemplo: 59:59 + (1s) = 01:00:00.
    limite = 1 : El reloj será fijo y al llegar al límite del parámetro máximo todos volverán a su estado inicial ejemplo: 23:59:59 + (1s) = 00:00:00.
    limite = 2 : El reloj será fijo y el parámetro maximo no tendrá limites ejemplo: 23:59:59 + (1s) = 24:00:00.

DEMO

import {Taimy, TaimyForm,TaimyReloj} from "taimy.js";

const img = document.getElementById('fotograma-clave');
const span = document.getElementById('cronometro');
const btn_x = document.getElementById('eliminar');
const btn_pausar = document.getElementById('pausar');
const btn_reiniciar = document.getElementById('reiniciar');
const input_fps = document.getElementById('fps');

let fps = 12;
input_fps.value = fps;

//secuencia de imágenes con nombres del 0 al 11 en formato PNG
const fotogramas = {
    frame : 0,
    siguiente(){
        if(this.frame > 11) 
            this.frame = 0;
        return `./${this.frame++}.png`;}}

//sección del cronómetro
const cronometro = new Taimy;

cronometro.funcion = function (ms){
    const formatoTiempo = TaimyForm(ms);
    span.innerText = TaimyReloj(formatoTiempo);
    }
cronometro.intervalo = 100;

//sección de la animación
const instanciaTaimy = new Taimy(
    cronometro=>{
        if(!cronometro){
            fotogramas.frame = 0;
            }
        img.src = fotogramas.siguiente();
        },
    {intervalo:1000/fps});

//comenzar la ejecución
instanciaTaimy.arrancar();
cronometro.arrancar();

// introducir los fps de la animación
input_fps.addEventListener('keydown',e =>{
    if(e.keyCode != 13 || !input_fps.value) 
        return;
    fps = input_fps.value;
    instanciaTaimy.intervalo = 1000/fps;
    });

//lógica de los botones

btn_x.addEventListener('click',()=>{
    cronometro.destructor();
    instanciaTaimy.destructor();
    });

btn_pausar.addEventListener('click',instanciaTaimy.interruptor);

btn_reiniciar.addEventListener('click',()=>{
    cronometro.reiniciar();
    instanciaTaimy.reiniciar();
    });
Todos los personajes presentados en esta librería fueron diseñados y creados por mí ~ Neko ★ Shooter.