npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

text-readability

v1.1.0

Published

npm package to calculate statistics from text to determine readability, complexity and grade level of a particular corpus.

Downloads

15,040

Readme

text-readability

npm package to calculate statistics from text to determine readability, complexity and grade level of a particular corpus.

A rewrite of textstat library in JS

Usage

install required packages with npm install text-readability

>>> import rs from 'text-readability';

>>> const testData = `
      Playing games has always been thought to be important to 
      the development of well-balanced and creative children; 
      however, what part, if any, they should play in the lives 
      of adults has never been researched that deeply. I believe 
      that playing games is every bit as important for adults 
      as for children. Not only is taking time out to play games 
      with our children and other adults valuable to building 
      interpersonal relationships but is also a wonderful way 
      to release built up tension. `

>>> rs.fleschReadingEase(testData)
>>> rs.fleschKincaidGrade(testData)
>>> rs.colemanLiauIndex(testData)
>>> rs.automatedReadabilityIndex(testData)
>>> rs.daleChallReadabilityScore(testData)
>>> rs.difficultWords(testData)
>>> rs.linsearWriteFormula(testData)
>>> rs.gunningFog(testData)
>>> rs.textStandard(testData)

The argument (text) for all the defined functions remains the same - i.e the text for which statistics need to be calculated.

Install using npm

npm install text-readability

List of Functions

Syllable Count

rs.syllableCount(text, lang='en-US')

Returns the number of syllables present in the given text.

Uses the npm module syllable for syllable calculation. lang currently only used for proper lowercasing
Should be passed to syllable or write own library for this

Lexicon Count

rs.lexiconCount(text, removePunctuation=true)

Calculates the number of words present in the text. Optional removePunctuation specifies whether we need to take punctuation symbols into account while counting lexicons. Default value is true, which removes the punctuation before counting lexicon items.

Sentence Count

rs.sentenceCount(text)

Returns the number of sentences present in the given text.

The Flesch Reading Ease formula

rs.fleschReadingEase(text)

Returns the Flesch Reading Ease Score.

The following table can be helpful to assess the ease of readability in a document.

The table is an example of values. While the maximum score is 121.22, there is no limit on how low the score can be. A negative score is valid.

| Score | Difficulty | |-------|-------------------| |90-100 | Very Easy | | 80-89 | Easy | | 70-79 | Fairly Easy | | 60-69 | Standard | | 50-59 | Fairly Difficult | | 30-49 | Difficult | | 0-29 | Very Confusing |

Further reading on Wikipedia

The Flesch-Kincaid Grade Level

rs.fleschKincaidGrade(text)

Returns the Flesch-Kincaid Grade of the given text. This is a grade formula in that a score of 9.3 means that a ninth grader would be able to read the document.

Further reading on Wikipedia

The Fog Scale (Gunning FOG Formula)

rs.gunningFog(text)

Returns the FOG index of the given text. This is a grade formula in that a score of 9.3 means that a ninth grader would be able to read the document.

Further reading on Wikipedia

The SMOG Index

rs.smogIndex(text)

Returns the SMOG index of the given text. This is a grade formula in that a score of 9.3 means that a ninth grader would be able to read the document.

Texts of fewer than 30 sentences are statistically invalid, because the SMOG formula was normed on 30-sentence samples. textstat requires atleast 3 sentences for a result.

Further reading on Wikipedia

Automated Readability Index

rs.automatedReadabilityIndex(text)

Returns the ARI (Automated Readability Index) which outputs a number that approximates the grade level needed to comprehend the text.

For example if the ARI is 6.5, then the grade level to comprehend the text is 6th to 7th grade.

Further reading on Wikipedia

The Coleman-Liau Index

rs.colemanLiauIndex(text)

Returns the grade level of the text using the Coleman-Liau Formula. This is a grade formula in that a score of 9.3 means that a ninth grader would be able to read the document.

Further reading on Wikipedia

Linsear Write Formula

rs.linsearWriteFormula(text)

Returns the grade level using the Linsear Write Formula. This is a grade formula in that a score of 9.3 means that a ninth grader would be able to read the document.

Further reading on Wikipedia

Dale-Chall Readability Score

rs.daleChallReadabilityScore(text)

Different from other tests, since it uses a lookup table of the most commonly used 3000 English words. Thus it returns the grade level using the New Dale-Chall Formula.

| Score | Understood by | |-------------|-----------------------------------------------| |4.9 or lower | average 4th-grade student or lower | | 5.0–5.9 | average 5th or 6th-grade student | | 6.0–6.9 | average 7th or 8th-grade student | | 7.0–7.9 | average 9th or 10th-grade student | | 8.0–8.9 | average 11th or 12th-grade student | | 9.0–9.9 | average 13th to 15th-grade (college) student |

Further reading on Wikipedia

Readability Consensus based upon all the above tests

rs.textStandard(text, float_output=False)

Based upon all the above tests, returns the estimated school grade level required to understand the text.

Optional float_output allows the score to be returned as a float. Defaults to false.