average-rating
Calculate average and scoring based on Wilson Score Equation
Install & Usage
npm i average-rating
pnpm i average-rating
yarn add average-rating
import {
score,
rate,
average
} from 'average-rating'
const {
score,
rate,
average
} = require('average-rating')
const {
score,
rate,
average
} = require('average-rating/dist/cjs/average-rating.js')
score(80, 20)
average([134055, 57472, 143135, 365957, 1448459])
rate([134055, 57472, 143135, 365957, 1448459])
Deno
import {
score,
rate,
average
} from 'npm:average-rating'
import {
score,
rate,
average
} from 'https://esm.sh/average-rating'
CDN
Currently ECMAScript modules work fine on almost browsers:
<script type="module">
import {
score,
rate,
average
} from 'https://unpkg.com/average-rating/dist/average-rating.esm.js'
score(0, 1000)
score(1000, 0)
score(1000, 1000)
const rating = [134055, 57472, 143135, 365957, 1448459]
rate(rating)
average(rating)
</script>
With outdated browsers, we can use traditional way:
<script type="text/javascript" src="https://unpkg.com/average-rating/dist/average-rating.min.js"></script>
<script>
const {
score,
rate,
average
} = window.AverageRating
</script>
APIs
.score(Number positive, Number negative)
Return a value from 0 to 1.
Used for the systems of Positive/Negative rating, such as the videos on YouTube, the answers on StackOverflow, etc. In which, each of item can be voted as good or bad, like or dislike or something like that.
.rate(Array ratings)
Return a value from 0 to 1.
Used for the systems of 5 rating levels, such as the applications on Google Play store, the books on Amazon, etc. In which, each of item can be voted as one of value in the range of 1 to 5 stars.
Update
- Since v1.1.5, this
rate
method accepts custom range of ratings. 5 or more values are OK.
const input = [3, 4, 2, 6, 12, 46, 134, 213, 116, 91, 45, 15, 58, 96, 1654]
rate(input)
rate([3, 4, 2, 6, 12, 46, 134, 213, 116, 91])
.average(Array ratings)
Return a value from 0 to 5.
Calculate normal average value for the systems of 5 rating levels.
Test
git clone https://github.com/ndaidong/average-rating.git
cd average-rating
npm install
npm test
License
The MIT License (MIT)