array-jumper

1.0.0 • Public • Published

array-jumper

Solves an annoying problem I've run into frequently with various cases where I want to get another item in an array based on some current value that I know is in the array.

installing

npm install array-jumper

how to use

var jumper = require('array-jumper');
 
// our demo array
var arr = ['a', 'b', 'c', 'd', 'e', 'f', 'g'];
 
 
// If non are specified jumper should return first
jumper(arr); // returns 'a'
 
// If no jump amount specified jumper should return
// next item in array
jumper(arr, 'a') // returns 'b'
 
// If jump amount specified is in range, jump to item
jumper(arr, 'a', 2) // returns 'c'
 
// Should work for negative
jumper(arr, 'c', -2) // returns 'a'
 
// Should work for zero
jumper(arr, 'a', 0) // returns 'a'
 
// Should loop around if given positive jump number that
// is out of range.
jumper(arr, 'a', 10) // returns 'd'
 
// Should loop around if given negative jump number that
// is out of range
jumper(arr, 'a', -10) // returns 'e'
 
// should work for item not found with no jump value
jumper(arr, 'z') // returns 'a'
 
// should work for item not found with jump value 1
jumper(arr, 'z', 1) // returns 'a'
 
// should work for item not found with jump value 2
jumper(arr, 'z', 2) // returns 'b'

credits

If you like this, follow @HenrikJoreteg on twitter.

Check out similar resources at: http://resources.humanjavascript.com.

And check out my book: http://humanjavascript.com

unit tests?

run them with npm test

read them here: test.js

changelog

  • 1.0.0: no longer throwing errors, and now handling missing args better
  • 0.0.1: initial release

license

MIT

Readme

Keywords

Package Sidebar

Install

npm i array-jumper

Weekly Downloads

0

Version

1.0.0

License

MIT

Last publish

Collaborators

  • henrikjoreteg