teeseal / discord.js-docs

discord.js docs parser.

discord.js docs

A parser and wrapper for the discord.js docs.

Usage

Doc

const Doc = require('discord.js-docs')

Doc.fetch(sourceName[, options])

Fetches and parses the docs for the given project.
sourceName can be any of the predefined values (stable, main, commando, rpc, akairo, collection, builders, voice and rest) or an URL which will return the raw generated docs (e.g https://raw.githubusercontent.com/discordjs/docs/main/discord.js/main.json ).
Once a documentation is fetched it will be cached. Use options.force to avoid this behavior.

Params:

name	type	required
sourceName	string	yes
options	object	no

Returns: Promise<Doc?>

const doc = await Doc.fetch('main')
const doc = await Doc.fetch('akairo', { force: true })
const doc = await Doc.fetch(
  'https://raw.githubusercontent.com/discordjs/rpc/docs/master.json',
  { force: true }
)

Doc#get(parent[, child1[ ...[, childN]]])

Gets documention for one element. Multiple properties/methods can be chained. Params:

name	type	required
parent	string	yes
...children	string	no

Returns: DocElement?

doc.get('message')
doc.get('message', 'guild')
doc.get('message', 'guild', 'members')

Doc#search(query)

Searches the documentation using fuzzy search for the given query and returns top 10 hits.

Params:

name	type	required
query	string	yes

Returns: Array<DocElement>?

Doc#resolveEmbed(query)

Tries to resolve the query into a DocElement using Doc#get. The search terms are expected to be separated by # or ., example: message#pin. If an element cannot be resolved, falls back to Doc#search. The result is then formatted into an object representing a Discord embed which can be sent directly to a Discord channel.

Params:

name	type	required
query	string	yes

Returns: object?

DocElement

Properties:

• doc - the Doc this element originates from;
• docType - the type of this documentation element. One of class, event, interface, method, param, prop and typedef;
• parent - parent element if present;
• name - self-explanatory;
• description - self-explanatory;
• meta - any meta information if present;
• returns - the type this element returns, if applicable;
• examples - code examples, if any;
• type - the JS type of this element, if applicable;
• nullable - tells whether this element can be null;
• deprecated - tells whether this element has been deprecated;
• access - access level for this element. Defaults to public;

discord.js-docs's Issues

DocBase.findChild's exclude doesn't work

referring to this, here

return Array.from(this.children.values()).find(child => (
      !exclude.includes(child) && child.name.toLowerCase() === query && (!docType || child.docType === docType)
))

this.children is a map with class instances as the values, so this is basically <string[]>.includes()
This should use .includes(child.name) instead however since the entire exclude feature is undocumented, i'd need to know if it was meant to be case sensitive?

i have this problem with the package

/home/runner//node_modules/discord.js-docs/src/DocBase.js:36
query = query.toLowerCase()
^

TypeError: Cannot read properties of undefined (reading 'toLowerCase')

Make nullable types show as nullable in embed

At the moment, Properties that can return null doesn't show up in ?type format.
Good example could be GuildMember.nickname. Type is just string, while at docs it's ?string

Make url valid

Can you make the urls valid please? 🥺🥺🥺