eh-parser: A JavaScript repository from chocolatl

解析e-hentai与exhentai各个页面的元数据

使用

npm install eh-parser --save

浏览器

EHParser通过解析DOM对象的文档节点获取数据，假设现在处于E站搜索结果页面，可以插入以下代码获取搜索数据：

  const EHParser = require('eh-parser');
  const data = EHParser.parseSearchPage(document);
  console.log(data);

也可以通过DOMParser API来获取其它页面的DOM对象：

  fetch('https://exhentai.org/g/1183625/18725a8da6', {
    credentials: 'same-origin'    // 发送cookie
  })
  .then(res => res.text())
  .then(html => {
    const document = new DOMParser().parseFromString(html, 'text/html');
    const data = EHParser.parseGalleryPage(document);
    console.log(data);
  });

Node.js

在Node环境中，需要使用jsdom或类似的库获取DOM对象的文档节点

  const JSDOM = require('jsdom').JSDOM;
  const EHParser = require('eh-parser');

  const document = new JSDOM(/* E站搜索结果页面的HTML文本 */).window.document;
  const data = EHParser.parseGalleryPage(document);
  console.log(data);

API

EHParser.parseSearchPage(document, noPaging?)

解析搜索结果页面数据，如：https://exhentai.org

返回结果示例：

{
  "mode": "Minimal+",   // Minimal, Minimal+, Compact, Extended, Thumbnail 之一，获取失败时为Unknown
  "curPage": 0,         // 当前页码，页码从0开始
  "maxPage": 25310,     // 最大页码，页码从0开始
  "prev": null,         // 搜索结果的上一页链接
  "next": "https://exhentai.org/?page=1",   // 搜索结果的下一页链接
  "results": [          // 当前页面的搜索结果
    {
      "title": "(C94) [あめうさぎ (飴玉コン)] CONFITURE (ご注文はうさぎですか?) [**翻訳]",
      "posted": "2018-11-25 15:17",
      "url": "https://exhentai.org/g/1319745/713400a20b/",
      "cover": "https://exhentai.org/t/60/8f/608f41dd673776c1a47c0ca70275f98342c6884f-2697059-2116-3000-jpg_l.jpg",
      "category": "Doujinshi",
      "rating": 4.5,     // 评分精度为0.5
      "uploader": "BlossomPlus" ,   // 该字段在Thumbnail模式下为空字符串
      "favorite": {           // 收藏信息，如果没有收藏该画廊则为null
        dir: 0,               // 收藏夹序号 0-9
        name: "Favorites 0"   // 收藏夹名
      }
    },
    // ...
  ]
}

解析/favorites页面会得到一个额外的favoritesInfo字段，包含以下内容：

{
  "order": "favorited",      // 排序方式：favorited或posted
  "dirs": [
    {
      "num": 49,             // 收藏数
      "name": "Favorites 0"  // 收藏夹名
    },
    {
      "num": 0,
      "name": "Favorites 1"
    }
  ],
  "current": -1              // 当前显示的收藏夹，对应dirs数组的序号，-1表示Show All Favorites
}

如果noPaing参数传入true，那么返回对象中将仅包含mode和results字段。该选项用于获取无分页器的搜索页面，如/popular

EHParser.parseGalleryPage(document)

解析画廊页面数据，如：https://exhentai.org/g/1183625/18725a8da6

返回结果示例：

{
  "curPage": 0,     // 当前页码，页码从0开始
  "maxPage": 9,     // 最大页码，页码从0开始
  "metaData": {
    "ntitle": "さざなみみぉ pixiv作品合集",
    "jtitle": "",
    "cover": "https://ehgt.org/t/05/1c/051cedd0089ebce224b14ccc98ba89d67ff3f284-954244-800-1119-jpg_250.jpg",
    "category": "Non-H",
    "uploader": "囧途末路",
    "posted": "2018-02-11 13:05",
    "parent": "https://exhentai.org/g/1161712/7d773196aa/",
    "visible": "No (Replaced)",
    "language": "Japanese",
    "fileSize": "182.2 MB",
    "length": "195 pages",
    "favorite": {           // 收藏信息，如果没有收藏该画廊则为null
      dir: 0,               // 收藏夹序号 0-9
      name: "Favorites 0"   // 收藏夹名
    },
    "favorited": "368 times",
    "ratingCount": 76,      // 评分人数
    "rating": 4.53,         // 平均评分
    "myRating": null,       // 我的评分
    "tags": [
      {
        "namespace": "parody",
        "tags": [
          {
            name: "touhou project",   // 标签名
            power: "100+",            // 1+、10+、100+ 详见：https://ehwiki.org/wiki/Tagging_Mechanics#Tag_Mod_Power
            state: "normal"           // normal、upvoted、downvoted、other 详见：https://ehwiki.org/wiki/Tagging_Mechanics#Tag_Colors
          },
          // ...
        ]
      },
      // ...
    ]
  },
  "newerVersions": [
    {
      "url": "https://exhentai.org/g/1205262/5bc2e2c3a6/",
      "title": "さざなみみぉ pixiv作品合集（不定期更新）",
      "posted": "2018-03-31 04:49"
    },
    {
      "url": "https://exhentai.org/g/1230782/a41bc04e18/",
      "title": "さざなみみぉ pixiv作品合集（不定期更新）",
      "posted": "2018-05-27 05:09"
    },
    // ...
  ],
  "uploaderComment": {
    "posted": "11 February 2018, 13:05",
    "author": "囧途末路",
    "content": "P站著名妖梦控画师的P站作品合集,按从早到晚顺序排列"
  },
  "comments": [
    {
      "posted": "30 December 2017, 07:12",
      "author": "536753924",
      "content": "画师没有好坏之分，但是さざなみみぉ，你的妖梦最可爱啦！",
      "score": "+41"
    },
    {
      "posted": "30 December 2017, 07:42",
      "author": "HamburgerHelper",
      "content": "Youmu is love.",
      "score": "+11"
    },
    // ...
  ],
  "imageList": {
    "mode": "large",        // mode为"normal"或"large"，与账号设置有关
    "list": [
      {
        "url": "https://exhentai.org/s/051cedd008/1183625-1",
        "thumb": "https://ehgt.org/05/1c/051cedd0089ebce224b14ccc98ba89d67ff3f284-954244-800-1119-jpg_l.jpg",
        "fileName": "001.jpg"
      },
      {
        "url": "https://exhentai.org/s/11286cf784/1183625-2",
        "thumb": "https://ehgt.org/11/28/11286cf7840f1726cdda95f619aaacd7d5a1f9fex1190142-800-1125-jpg_l.jpg",
        "fileName": "002.jpg"
      },
      // ...
    ]
  },
  "apiInfo": {
    "url": "https://exhentai.org/api.php",
    "gid": 1183625,
    "token": "18725a8da6",
    "apiuid": 0,
    "apikey": ""
  }
}

模式为normal时的imageList字段：

{
  "mode": "normal",
  "list": [
    {
      "sprites": "https://exhentai.org/m/001183/1183625-00.jpg",   // CSS Sprites，通过w、h、x、y可以计算出缩略图位置
      "w": "100px",
      "h": "140px",
      "x": "0px",
      "y": "0px",
      "url": "https://exhentai.org/s/051cedd008/1183625-1",
      "fileName": "001.jpg"
    },
    // ...
  ]

文件大小等字段与网页显示结果一致，意味着不是一个精确的数值，如果需要精确的数值可以调用官方API获取

EHParser.parsePicturePage(document)

解析图片页面数据，如：https://exhentai.org/s/594b7edc82/1183625-31

返回结果示例：

{
  "image": "http://144.197.142.91:8484/h/647afa68f7a97d990f360262f0e3bab872fbd501-216944-900-900-jpg/keystamp=1543465500-a9c0673140;fileindex=24684240;xres=2400/Masterpiece.jpg",
  "original": "https://exhentai.org/fullimg.php?gid=1316052&page=3&key=0cz2qum96tg",    // 原图下载链接，不存在时为null
  "next": "https://exhentai.org/s/eeda3df9cf/1316052-4",                                // 下一张图片的页面，最后一张时为null
  "curPage": 4,     // 当前页码，页码从1开始
  "maxPage": 220,   // 最大页码，页码从1开始
  "reloadCode": "23626-428740",
  "fileName": "Masterpiece.jpg"
}

reloadCode字段用于生成页面中Click here if the image fails loading的链接：

  const imagePageURL = 'https://exhentai.org/s/594b7edc82/1183625-31';
  const reloadURL    = imagePageURL + (imagePageURL.indexOf('?') > -1 ? '&' : '?') + 'nl=' + reloadCode;

许可证

GLWT（祝你好运）公共许可证
版权所有（C）每个人，除了作者

任何人都被允许复制、分发、修改、合并、销售、出版、再授权或
任何其它操作，但风险自负。

作者对这个项目中的代码一无所知。
代码处于可用或不可用状态，没有第三种情况。


                祝你好运公共许可证
            复制、分发和修改的条款和条件

0：在不导致作者被指责或承担责任的情况下，你可以做任何你想
要做的事情。

无论是在合同行为、侵权行为或其它因使用本软件产生的情形，作
者不对任何索赔、损害承担责任。

祝你好运及一帆风顺

chocolatl/eh-parser

使用

浏览器

Node.js

API

EHParser.parseSearchPage(document, noPaging?)

EHParser.parseGalleryPage(document)

EHParser.parsePicturePage(document)

许可证