new MultiReddit()
A class representing a multireddit.
Example
// Get a multireddit belonging to a specific user
r.getUser('multi-mod').getMultireddit('coding_languages')
Methods
-
copy(options)
Copies this multireddit to the requester's own account.
-
Parameters:
Name Type Description optionsobject Properties
Name Type Description newNamestring The new name for the copied multireddit
Returns:
A Promise for the newly-copied multireddit
- Type
- Promise
Example
r.getUser('multi-mod').getMultireddit('coding_languages').copy({newName: 'my_coding_languages_copy'}) -
rename(options)
Renames this multireddit.
-
Note: This method mutates this MultiReddit.
Parameters:
Name Type Description optionsobject Properties
Name Type Description newNamestring The new name for this multireddit.
- Deprecated:
-
- Reddit no longer provides the corresponding API endpoint. Please use `edit()` with a new name.
Returns:
A Promise that fulfills with this multireddit
- Type
- Promise
Example
r.getUser('multi-mod').getMultireddit('coding_languages').copy({newName: 'cookie_languages '}) -
edit(options)
Edits the properties of this multireddit.
-
Note: Any omitted properties here will simply retain their previous values.
Parameters:
Name Type Description optionsobject Properties
Name Type Argument Description namestring <optional>
The name of the new multireddit. 50 characters max.
descriptionstring <optional>
A description for the new multireddit, in markdown.
visibilitystring <optional>
The multireddit's visibility setting. One of
private,public,hidden.icon_namestring <optional>
One of
art and design,ask,books,business,cars,comics,cute animals,diy,entertainment,food and drink,funny,games,grooming,health,life advice,military,models pinup,music,news,philosophy,pictures and gifs,science,shopping,sports,style,tech,travel,unusual stories,video,Nonekey_colorstring <optional>
A six-digit RGB hex color, preceded by '#'
weighting_schemestring <optional>
One of 'classic', 'fresh'
Returns:
The updated version of this multireddit
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').edit({visibility: 'hidden'}) -
addSubreddit(sub)
Adds a subreddit to this multireddit.
-
Parameters:
Name Type Description subSubreddit The Subreddit object to add (or a string representing a subreddit name)
Returns:
A Promise that fulfills with this multireddit when the reuqest is complete
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').addSubreddit('cookies') -
removeSubreddit(sub)
Removes a subreddit from this multireddit.
-
Parameters:
Name Type Description subSubreddit The Subreddit object to remove (or a string representing a subreddit name)
Returns:
A Promise that fulfills with this multireddit when the request is complete
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').removeSubreddit('cookies') -
delete()
Deletes this multireddit.
-
Returns:
A Promise that fulfills when this request is complete
- Type
- Promise
Example
r.getUser('not_an_aardvark').getMultireddit('cookie_languages').delete()