procedure/Article

select-by-category-id--async-throw.js

const readAllRecordIds = require("../sub-procedure/read-all-record-ids--async-throw");
const selectArticleById = require("./select-by-id--async-throw");
const Article = require("../../type/Article");

module.exports = async (
   in_categoryId = "",
   out_selected = [],
   in_top = Infinity,
   in_order = "default" /* default | reversed */
) => {
   /* --- Collect all records' ids */
   var allRecordIds = [];
   await readAllRecordIds(Article.name, allRecordIds);

   /* --- Order id-list */
   if (in_order == "default")
      { /* keep default order */; }
   else
      allRecordIds.reverse();

   /* --- Loop & Select each record to check */
   for (var recordId of allRecordIds) {
      /* --- Limit the result set */
      if (out_selected.length == in_top)
         break /* out of the loop */;
      else
         { /* keep collecting record */; }

      /* --- Select an Article */
      var record = new Article();
      await selectArticleById(recordId, record);

      /* --- Collect the Article if category-id matches */
      if (record.get("category-id") != in_categoryId)
         { /* record is not matched */; }
      else
         out_selected.push(record);
   } // for
};