Quran.js/README.md

2.3 KiB

About

@0x1eef/quran provides a programmer's interface to The Noble Quran, alongside various translations. At the time of writing there is support for the Arabic, English, and Farsi languages.

Examples

Quran.locales

The Quran.locales getter provides an object where the key is a locale name (such as en) and the value is a locale object. The locales returned by this method indicate what languages the @0x1eef/quran library supports:

#!/usr/bin/env node
import { Quran } from "@0x1eef/quran";

(() => {
  const locales = Object.keys(Quran.locales);
  locales.forEach((key) => {
    const locale = Quran.locales[key];
    console.log("The Noble Quran for ", locale.displayName, " speakers");
  });
  /*
    The Noble Quran for English speakers
    The Noble Quran for العربية speakers
    The Noble Quran for فارسی speakers
  */
})();

Quran.surahs

The Quran.surahs getter provides an object where the key is a locale name (such as en) and the value is a surah object. For example:

#!/usr/bin/env node
import { Quran } from "@0x1eef/quran";

(() => {
  const surah = Quran.surahs["en"][0];
  const ayah = surah.ayat[0].body;
  console.log(ayah);
  /*
     In the Name of Allah —
     the Most Compassionate, Most Merciful.
   */
})();

Documentation

A complete API reference is available at 0x1eef.github.io/x/Quran.js

Install

@0x1eef/quran is available via npm:

npm i @0x1eef/quran

Thanks

الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ

Thanks to the translators:

  • English (The Clear Quran) by Dr. Mustafa Khattab
  • Farsi by Hussain Ansarian

Sources

License

The "source code" is released under the terms of the GPL
See LICENSE for details