Subscribe

Adding reading time to Astro (the easy way)

✍️

How to add a reading time to your Astro powered blog

19 Nov, 2021 · 3 min read

You may have noted that this blog, along with many others, provides reading time.

This reading time indicates how long it would take to read an article.

Reading time on a blog

This is valuable information, as sometimes you want to be aware of what you are getting into while starting to read an article.

Adding a reading time to Astro

We’ll be going for the easy way. Meaning it’s not a scientific approach and is more used as a guideline than a perfect number.

First, let’s take the Astro blog starter and work from there.

Install the starter template with the following command.

mkdir astro-blog && cd astro-blog
npm init astro -- --template blog-multiple-authors

We’ll be adding our reading time script on the post overview page so the visitor can determine which article they want to read.

First, let’s create the file that will determine the actual reading time.

I created a lib folder in the src directory for these little scripts, creating a readingtime.js file.

Then add the following template, which creates a function that accepts content and should return the reading time.

export function getReadingTime(content) {
  if (!content) return;
  // Do something
}

Now open up the components/PostPreview.astro and import this script like so:

---
import { getReadingTime } from '../lib/readingtime.js'

// Rest of frontmatter
---

And in our HTML section, we can use it like so:

<p>{getReadingTime(post.astro.html)} minutes to read</p>

We invoke the function and pass the HTML of the post content. However, nothing will happen at this point.

So head back over to the readingtime.js file. The first thing we need to do is determine what the average person reads per minute.

This is widely known to be between 200/250 words, so let’s stick to the lower number.

Read more on the number of words read per minute

With this in mind, we can create a variable that states this number.

const WORDS_PER_MINUTE = 200;

The content we pass is pure HTML, including all HTML tags, images, etc., which we don’t want to count towards the reading time.

We can’t use document manipulation in Astro, so let’s use a regex to remove these elements.

export function getReadingTime(content) {
  if (!content) return;
  const clean = content.replace(/<\/?[^>]+(>|$)/g, '');
}

Then we can extract the number of words from our cleaned string by splitting it into spaces.

const numberOfWords = clean.split(/\s/g).length;

Lastly, we can divide the number of words by our word per minute variable and round this up.

Making the function look like this:

const WORDS_PER_MINUTE = 200;

export function getReadingTime(content) {
  if (!content) return;
  const clean = content.replace(/<\/?[^>]+(>|$)/g, '');
  const numberOfWords = clean.split(/\s/g).length;
  return Math.ceil(numberOfWords / WORDS_PER_MINUTE);
}

If we now go to our website, we should see the reading times pop-up.

Reading time in action

For reference purposes, you can also find the completed code example on GitHub.

Thank you for reading, and let’s connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Spread the knowledge with fellow developers on Twitter
Tweet this tip
Powered by Webmentions - Learn more

Read next 📖

Computed Nano Stores

6 Sep, 2022 · 2 min read

Computed Nano Stores

Astro Nano Stores maps

5 Sep, 2022 · 3 min read

Astro Nano Stores maps

Join 2097 devs and subscribe to my newsletter