Cite/set.js

  1. import {chain as parseInput, chainAsync as parseInputAsync} from '../parse/'
  2. import fetchId from '../util/fetchId'
  4. /**
  5.  * Add an object to the array of objects
  6.  *
  7.  * @memberof Cite#
  8.  *
  9.  * @param {Cite~InputData} data - The data to add to your object
  10.  * @param {Object} [options={}] - [Options](../#cite.in.options)
  11.  * @param {Boolean} [log=false] - Show this call in the log
  12.  *
  13.  * @return {Cite} The updated parent object
  14.  */
  15. const add = function (data, options = {}, log = false) {
  16.   if (options === true || log === true) {
  17.     this.save()
  18.   }
  20.   this.data.push(...parseInput(data, options))
  22.   this.data.filter(entry => !entry.hasOwnProperty('id')).forEach(entry => {
  23.     entry.id = fetchId(this.getIds(), 'temp_id_')
  24.   })
  26.   return this
  27. }
  29. /**
  30.  * Add an object to the array of objects
  31.  *
  32.  * @memberof Cite#
  33.  *
  34.  * @param {Cite~InputData} data - The data to add to your object
  35.  * @param {Object} [options={}] - [Options](../#cite.in.options)
  36.  * @param {Boolean} [log=false] - Show this call in the log
  37.  *
  38.  * @return {Promise<Cite>} The updated parent object
  39.  */
  40. const addAsync = async function (data, options = {}, log = false) {
  41.   if (options === true || log === true) {
  42.     this.save()
  43.   }
  45.   this.data.push(...await parseInputAsync(data, options))
  47.   this.data.filter(entry => !entry.hasOwnProperty('id')).forEach(entry => {
  48.     entry.id = fetchId(this.getIds(), 'temp_id_')
  49.   })
  51.   return this
  52. }
  54. /**
  55.  * Recreate a `Cite` object with almost any kind of data, and manipulate it with its default methods.
  56.  *
  57.  * @memberof Cite#
  58.  *
  59.  * @param {Cite~InputData} data - Replacement data
  60.  * @param {Object} [options={}] - [Options](../#cite.in.options)
  61.  * @param {Boolean} [log=false] - Show this call in the log
  62.  *
  63.  * @return {Cite} The updated parent object
  64.  */
  65. const set = function (data, options = {}, log = false) {
  66.   if (options === true || log === true) {
  67.     this.save()
  68.   }
  70.   this.data = []
  71.   return typeof options !== 'boolean' ? this.add(data, options) : this.add(data)
  72. }
  74. /**
  75.  * Recreate a `Cite` object with almost any kind of data, and manipulate it with its default methods.
  76.  *
  77.  * @memberof Cite#
  78.  *
  79.  * @param {Cite~InputData} data - Replacement data
  80.  * @param {Object} [options={}] - [Options](../#cite.in.options)
  81.  * @param {Boolean} [log=false] - Show this call in the log
  82.  *
  83.  * @return {Promise<Cite>} The updated parent object
  84.  */
  85. const setAsync = async function (data, options = {}, log = false) {
  86.   if (options === true || log === true) {
  87.     this.save()
  88.   }
  90.   this.data = []
  91.   return typeof options !== 'boolean' ? this.addAsync(data, options) : this.addAsync(data)
  92. }
  94. /**
  95.  * Reset a `Cite` object.
  96.  *
  97.  * @memberof Cite#
  98.  *
  99.  * @param {Boolean} [log=false] - Show this call in the log
  100.  *
  101.  * @return {Cite} The updated, empty parent object (except the log, the log lives)
  102.  */
  103. const reset = function (log) {
  104.   if (log) {
  105.     this.save()
  106.   }
  108.   this.data = []
  109.   this._options = {}
  111.   return this
  112. }
  114. export { add, addAsync, set, setAsync, reset }