reading-time-estimator
TypeScript icon, indicating that this package has built-in type declarations

1.10.0 • Public • Published

reading-time-estimator

Test Lint Semantic Release Commitizen friendly semantic-release npm npm npm bundle size (minified)

All Contributors

forthebadge forthebadge forthebadge

A medium's like reading time estimator with internationalization support.

Documentation

Reading Time Estimator was created to provide an estimate of how long to read an article or blog as seen on medium.

Installation

With NPM

  npm install reading-time-estimator

or Yarn

  yarn add reading-time-estimator

API

The api is fairly simple. Here are the types definition for this module.

It is a simple function that takes the data as a required argument with the words per minute and locale as optional arguments.

Per default the locale is set to english en.

Per default the word per minute is set to 300.

At the moment there is only 9 supported locales: en, fr, es, pt-br, cn, ja, de, tr and ro.

Usage

Try it live here

import { readingTime } from 'reading-time-estimator'

const text = 'some text to parse'

// default options
const result = readingTime(text, 10)

// output:
// {
//   minutes: 4,
//   words: 43,
//   text: `4 min read`
// }

// with french locale
const result = readingTime(text, 10, 'fr')

// output:
// {
//   minutes: 4,
//   words: 43,
//   text: `4 min de lecture`
// }

Why Not ...?

reading-time

This package does not offer internationalization support which was a must for me.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Lucien Bénié
Lucien Bénié

💻 📖
Victor Sierra
Victor Sierra

💻
ZhangC
ZhangC

💻
Rich11
Rich11

💻 📖
Matheus Oliveira
Matheus Oliveira

💻
Can Güven
Can Güven

💻
Alexander Strutz
Alexander Strutz

💻
凝结尾迹
凝结尾迹

💻
Muhammad Faisal Amin
Muhammad Faisal Amin

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Package Sidebar

Install

npm i reading-time-estimator

Weekly Downloads

2,383

Version

1.10.0

License

MIT

Unpacked Size

14.8 kB

Total Files

20

Last publish

Collaborators

  • lbenie