Pular para o conteúdo

ct.timer


ct.timer

ct.timer permite a criação de temporizadores, opcionalmente executando uma função quando o temporizador chegar em uma certa quantidade de tempo.

Exemplos:

// Adiciona um temporizador
ct.timer.add(1000, 'test');
// Ou:
new CtTimer(1000, 'test');
// Cria uma novo temporizador e o armazena em uma variável chamada `timer`
// Registra no console "Done!" quando tiver decorrido 2.5 segundos
var timer = ct.timer.add(2500, 'test');
timer.then(() => {
    // Faz alguma coisa útil
    hero.invincible = false;
    console.log('Done!');
})
// O `catch` é uma parte não necessária. Sem ele, você verá erros no console quando o temporizador for interrompido, 
// manualmente ou quando você trocar de rooms
.catch(e => {
    console.log('Timer removed', e);
    // Você pode adicionar código aqui para que coisas importantes ainda
    // sejam executadas na troca de room:
    hero.invincible = false;
});

// Registra no console a quantidade de tempo que resta
console.log(timer.time);

// Para o temporizador. Note que nesse caso não será chamado o código dentro da instrução `then(() => {})`
timer.reject();

// Aciona o temporizador manualmente
timer.resolve();

métodos ct.timer

ct.timer.add(timeMs, name) ⇒ void

Cria um novo temporizador que executa na escala de tempo do jogo e é afetado pela aceleração/desaceleração do tempo.

ParâmetroTipoDescrição
timeMsNumberO tempo de espera do temporizador em milissegundos
[name]StringO nome do temporizador, o qual pode ser acessado através de timer.name.

ct.timer.addUi(timeMs, name) ⇒ void

Cria um novo temporizador que executa na escala de tempo de UI.

ParâmetroTipoDescrição
timeMsNumberO tempo de espera do temporizador em milessegundos
[name]StringO nome do temporizador, o qual pode ser acessado através de timer.name.

Propriedades do temporizador

CtTimer.time ⇒ Number

A quantidade de tempo em que o temporizador ficou ativo, em milissegundos.

CtTimer.timeLeft ⇒ Number

A quantidade de tempo restante até chegar ao timeMs. O valor padrão é 0.

CtTimer.nameopen in new windowString|false

Retorna o nome do temporizador ou false se nenhuma nome foi atribuído.

CtTimer.uiDelta ⇒ Boolean

Se true, será usado o ct.deltaUi contar o tempo. Se false, será usado ct.delta para contar o tempo.

CtTimer.promise ⇒ Promise

A promise usado para executar os callbacks quando o temporizador for finalizado. Você pode usá-lo com outras promises e métodos Promiseopen in new window para criar um complexo encadeamento assíncrono.

CtTimer.resolve ⇒ Function

Aciona de forma instantânea a promise chamando o seu callback.

CtTimer.reject ⇒ Function

Para o temporizador rejeitando a sua promise interno.

CtTimer.rejected ⇒ Boolean

Se true, significa que o temporizador foi rejeitado.

CtTimer.done ⇒ Boolean

Se true, significa que o temporizador foi resolvido.

CtTimer.settled ⇒ Boolean

Se true, indica que o temporizador foi rejeitado ou resolvido.

Métodos do temporizador

CtTimer.then ⇒ void

Um espelho para CtTimer.promise.then().

Anexa o callbacks para a resolução e/ou rejeição da Promise interna.

ParâmetroTipoDescrição
onfulfilledAnyO callback a ser executado quando a Promise é resolvida.
[onrejected]AnyO callback a ser executado quando a Promise é rejeitada.

CtTimer.catch ⇒ void

Um espelho para CtTimer.promise.catch().

Anexa o callbacks para a rejeição da Promise interna.

ParâmetroTipoDescrição
onfulfilledAnyO callback a ser executado quando a Promise é resolvida.
[onrejected]AnyO callback a ser executado quando a Promise é rejeitada.