搜索 (search)

search() 是用户在搜索框输入关键词时调用的函数。

函数签名

function search(keyword, page) → BookItem[]

参数	类型	说明
keyword	string	用户输入的搜索关键词
page	number	页码，从 1 开始

返回 BookItem[] 数组，每个元素包含：

字段	类型	必填	说明
name	string	✅	书名
bookUrl	string	✅	书籍详情页 URL
author	string	推荐	作者
coverUrl	string	推荐	封面图片 URL
intro	string	否	简介
latestChapter	string	否	最新章节名
kind	string	否	分类标签

HTML 站点示例

function search(keyword, page) {
  legado.log('[search] keyword=' + keyword + ' page=' + page);

  var html = legado.http.get(BASE + '/search?q=' + encodeURIComponent(keyword) + '&page=' + page);
  var doc = legado.dom.parse(html);
  var items = legado.dom.selectAll(doc, '.bookbox');
  var books = [];

  for (var i = 0; i < items.length; i++) {
    var el = items[i];
    books.push({
      name: legado.dom.selectText(el, 'h4 a'),
      author: legado.dom.selectText(el, '.author'),
      bookUrl: legado.dom.selectAttr(el, 'h4 a', 'href'),
      coverUrl: legado.dom.selectAttr(el, 'img', 'src')
    });
  }

  legado.log('[search] found=' + books.length);
  legado.dom.free(doc);
  return books;
}

JSON API 示例

function search(keyword, page) {
  legado.log('[search] keyword=' + keyword + ' page=' + page);

  var resp = legado.http.get(
    BASE + '/api/search?keyword=' + encodeURIComponent(keyword) + '&page=' + page
  );
  var json = JSON.parse(resp);

  return (json.data.list || []).map(function(book) {
    return {
      name: book.title,
      bookUrl: BASE + '/book/' + book.id,
      author: book.author,
      coverUrl: book.cover,
      intro: book.summary
    };
  });
}

POST 搜索

某些站点的搜索需要 POST 请求：

function search(keyword, page) {
  var body = 'searchkey=' + encodeURIComponent(keyword) + '&page=' + page;
  var html = legado.http.post(BASE + '/search.php', body);
  var doc = legado.dom.parse(html);
  // ... 解析逻辑
}

GBK 编码

部分老旧站点使用 GBK 编码：

function search(keyword, page) {
  var encoded = legado.urlEncodeCharset(keyword, 'gbk');
  var html = legado.http.get(BASE + '/search.php?keyword=' + encoded);
  // ...
}

封面 URL 兼容

不同站点的图片 URL 可能在不同属性中：

// 兼容 data-src / data-original / src
function getCover(el) {
  return legado.dom.selectAttr(el, 'img', 'data-src')
      || legado.dom.selectAttr(el, 'img', 'data-original')
      || legado.dom.selectAttr(el, 'img', 'src')
      || '';
}

日志规范

每个函数入口都应打印关键参数日志，方便调试：

legado.log('[search] keyword=' + keyword + ' page=' + page);