Skip to content

Rank an array of objects with support for value ties

License

Notifications You must be signed in to change notification settings

mdchristians/ranky

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation



Ranky

Rank an array of objects with support for value ties and tie breakers

Install

$ npm install rankyjs

Usage

const ranky = require('rankyjs');

// Input data
const data = [
  { name: 'Ken Morrow', goals: 13, assists: 13, points: 26 },
  { name: 'Mark Johnson', goals: 8, assists: 10, points: 18 },
  { name: 'Mike Ramsey', goals: 15, assists: 6, points: 21 },
  { name: 'Mike Eruzione', goals: 15, assists: 10, points: 25 },
  { name: 'Dave Silk', goals: 21, assists: 8, points: 29 }
];

const options = {
  arr: data,
  key: 'points'
};

const rankings = ranky(options);

console.log(rankings);
// [
//  { name: 'Mark Johnson', goals: 8, assists: 10, points: 18, pos: 1, rank: 1 },
//  { name: 'Mike Ramsey', goals: 15, assists: 6, points: 21, pos: 2, rank: 2 },
//  { name: 'Mike Eruzione', goals: 15, assists: 10, points: 25, pos: 3, rank: 3 },
//  { name: 'Ken Morrow', goals: 13, assists: 13, points: 26, pos: 4, rank: 4 },
//  { name: 'Dave Silk', goals: 21, assists: 8, points: 29, pos: 5, rank: 5 }
// ]

Options

Ranky takes a single parameter that is used to specify a few options when ranking the array of data.

arr (required)

Type: array

The array of objects that will be ranked.

key (required)

Type: string

The key used for sorting the objects within the array.

tieString

Type: string

Default T

The string used to prefix any ties that are found within the rankings. For example, if to values of the given key are identical at 2nd place the rank given for both would be ${tieString}2.

size

Type: number

Default false

The amount of items returned in the ranked array - starting from the top of the list. The size option only accepts a number.

order

Type: string

Default asc

Must be either asc or desc!

License

MIT © Matt Christians

About

Rank an array of objects with support for value ties

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published