An npm package that fetches the World of Warcraft ingame events from https://wowhead.com/events using Axios & Cheerio.

Report a Bug | Request a New Feature | Help Develop This Project | Fund Me

Loved the project? Please consider giving a star :)

---

Available Functions

getActiveEvents (Promise)

const calendar = require("wow-calendar.js");

calendar.getActiveEvents([locale]).then(result => {
  //Result: Array Of All Active Events (Objects; Including Event Descriptions & Event Icon URLs)

  //Additionally
  //
  //If the description request in the desired locale results in too many redirects because of URL encoding
  //this function automatically falls back to english and also returns:
  //
  //descriptionFallback: true
  //
  //Updating your Node.js version might fix this "Too Many Redirects" issue. It did at least for me.
  //At the moment it seems to work with v18+.
})

Parameter	Type	Description	Possible Values
locale	string	Optional (Default: en). The language you wish the results to be in.	de, es, fr, it, pt, ru, ko, cn

---

getAllEvents (Promise)

const calendar = require("wow-calendar.js");

calendar.getAllEvents([locale]).then(result => {
  //Result: Array Of All Events (Objects)
})

Parameter	Type	Description	Possible Values
locale	string	Optional (Default: en). The language you wish the results to be in.	de, es, fr, it, pt, ru, ko, cn

---

getEvent (Promise)

const calendar = require("wow-calendar.js");

calendar.getEvent(id, [locale]).then(result => {
  //Result: Event Object (Including Event Descriptions & Event Icon URLs)
})

Parameter	Type	Description	Possible Values
id	integer	The WoW event id.	e.g. 181, 643, ...
locale	string	Optional (Default: en). The language you wish the results to be in.	de, es, fr, it, pt, ru, ko, cn

---

Help Wanted!

Feel free to submit pull requests that improve the README, functions, documentation and overall code quality!