Node.JS module for handling nhentai.net API.
- Objective-oriented API abstraction.
- Bidirectional inspecting (get image from book/get book from image).
- Easy proxy support by using custom Agent (like this one).
- Return URLs for binary data (images).
Install via yarn:
yarn add nhentai-api
Install via npm:
npm i nhentai-api
Read the docs on GitHub pages.
const { API, TagTypes, } = require('nhentai-api');
import { API, TagTypes, } from 'nhentai-api';
const api = new API();
api.getBook(177013).then(book => {
api.getImageURL(book.cover); // https://t.nhentai.net/galleries/987560/cover.jpg
api.getImageURL(book.pages[1]); // https://i.nhentai.net/galleries/987560/2.jpg
});
await api.getRandomBook(); // Book instance
api.search('test').then(async search => {
console.log(search); /*
Search {
api: API { hosts: [Object], ssl: true, agent: [Agent] },
query: 'test',
page: 1,
perPage: 25,
books: [
[Book], [Book], [Book], [Book],
[Book], [Book], [Book], [Book],
[Book], [Book], [Book], [Book],
[Book], [Book], [Book], [Book],
[Book], [Book], [Book], [Book],
[Book], [Book], [Book], [Book],
[Book]
],
pages: 67
} */
search = await search.getNextPage(); // Same as api.search('text', 2);
console.log(search); /*
Search {
// Same as above
page: 2,
// Same as above
books: [
// Books from 2nd page of search
],
// Same as above
} */
});
In case you need to change API implementation (e.g. change proxy) you can pass api
to
search.getNextPage(api);
You can also use async generator:
// Get first 2 pages
for await (const search of api.searchGenerator('test')) {
console.log(search);
if (search.page >= 2)
break;
}
book.tags
has type of TagsArray
, it is just an Array<Tag>
with helper methods.
const tag = book.tags[0]; // Tag
tag.id;
tag.name;
// or
tag.toString();
tag.toString(true);
tag.type.type;
// or
tag.type.toString();
book.pureTags; // pure tags (with type 'tag')
book.categories; // category tags
book.artists; // artist tags
book.parodies; // parody tags
book.characters; // character tags
book.groups; // group tags
book.languages; // language tags
Get artists:
book.artists;
// or
book.getTagsWith({
type: TagTypes.Artist, // you may also use Tag.types.Artist or Tag.types.get('artist')
}); // TagsArray (subclass of Array<Tag>)
// or
book.getTagsWith({ type: 'artist', }); // TagsArray (subclass of Array<Tag>)
Get tag with name english
:
book.getTagsWith({ name: 'english', }); // TagsArray (subclass of Array<Tag>)
Get categories
book.categories;
// or
book.getTagsWith({ type: TagTypes.Category, }); // Recommended
// or
book.getTagsWith({ type: Tag.types.Category, });
// or
book.getTagsWith({ type: Tag.types.get('category'), });
// or
book.getTagsWith({ type: 'category', });
Without counts:
book.tags.toNames().join(', ');
// or
book.tags.join(', ');
With counts:
book.tags.toNames(true).join(', ');
// or
book.tags.map(tag => tag.toString(true)).join(', ')
Get all artists:
// With counts
book.artists.toNames(true).join(', ');
// or
book.getTagsWith({ type: TagTypes.Artist, }).toNames(true).join(', ');
// Without counts
book.artists.join(', ');
// or
book.artists.toNames().join(', ');
// or
book.getTagsWith({ type: TagTypes.Artist, }).join(', ');