reading-time-estimator

reading-time-estimator

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 12 supported locales: en, fr, es, pt-br, cn, ja, de, tr, ro, bn, sk and cs.

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é 💻 📖	Victor Sierra 💻	ZhangC 💻	Rich11 💻 📖	Matheus Oliveira 💻	Can Güven 💻	Alexander Strutz 💻
凝结尾迹 💻	Muhammad Faisal Amin 💻	Oliver Groma 💻

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

Changelog

1.11.0 (2024-04-02)

:sparkles: Features

• add slovak and czech languages (#1416) (557050d)

:memo: Documenation

• add Grolicek as a contributor for code (#1378) (d45072c)

:white_check_mark: Chores

• deps: update dependency @lbenie/linting to v1.7.4 (aa06311)
• deps: update dependency @lbenie/linting to v1.7.5 (9945a56)
• deps: update dependency @lbenie/linting to v1.7.6 (6a3cfb9)
• deps: update dependency @semantic-release/release-notes-generator to v13 (49a72ac)
• deps: update dependency @types/node to v20.11.29 (440fbc5)
• deps: update dependency @types/node to v20.11.30 (aab587b)
• deps: update dependency @types/node to v20.12.2 (d3b9233)
• deps: update dependency rollup to v4.13.1 (7022e87)
• deps: update dependency rollup to v4.13.2 (b718ffb)
• deps: update dependency semantic-release to v23.0.5 (eccc191)
• deps: update dependency semantic-release to v23.0.6 (3b71b63)
• deps: update dependency typescript to v5.4.3 (5860f43)
• deps: update dependency vite to v5.2.2 (db510c2)
• deps: update dependency vite to v5.2.3 (6368fe4)
• deps: update dependency vite to v5.2.4 (c260019)
• deps: update dependency vite to v5.2.5 (a6190fb)
• deps: update dependency vite to v5.2.6 (f7baf36)
• deps: update dependency vite to v5.2.7 (a492e63)
• docs: update readme (c659758)
• deps: update wagoid/commitlint-github-action action to v6 (#1411) (326cfed)