konami-ramen v0.5.1

konami-ramen 🍜

A highly sophisticated easter egg library with zero dependancies written in Typescript. By default it will listen for the famouse Konami Code. Brotli size = ~0.56kb

Demo

See it in action here 🍜

Installation

npm install konami-ramen

Usage

import Konami from 'konami-ramen';

const konami = new Konami();
konami.listen();

konami.on('success',()=>{
  console.log("Mmmmh ... that's tasty ramen!")
})

Custom Sequence

The default sequence is the Konami Code (↑ ↑ ↓ ↓ ← → ← → a b).

You can pass in your own sequence like so:

new Konami({ sequence: ['r','a','m','e','n'] });

The Sequence needs to be composed of KeyboardEvent.key values. See the full list here: https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values

Timeout

You can define the max. time between two key strokes, to make it event harder to enter the sequence. The default time is set to 600ms. Going below 200ms makes it almost impossible to hit the sequence in the right order and time.

new Konami({ timeout: 450 }); // time in ms

Note: If the max. time between two key strokes is exceeded, the validation will start from the begining.

Events

There are a couple of events, you can listen to, like so:

/* press ⬆️ */
konami.on('input', (event) => {
  /* { key: 'ArrowUp', match: true, position: 0, { native KeyboardEvent } } */
  /* your magic goes here */
})

Removing them is quite easy:

konami.off('input')

Here is a list of all events:

key \ The key property holds the current key pressed by the user.

postion \ The position property holds the current position in the pattern. If the current button is not matched with the pattern, position will be -1 instead.

lastPosition \ The lastPosition property holds last position if the pattern has been successfuly finished.

lastKey \ The lastKey property holds last key if the pattern has been successfuly finished.

match \ The match property holds the matching state of the most recent input.

lastMatch \ The lastMatch property holds the matching state of the most recent input, after a timeout occured.

keyboardEvent \ The keyboardEvent is the native keyboard event for the keydown event.

Lincense

MIT