\n \n \n | Argument | \n Type | \n Description | \n Required | \n
\n \n \n name | \n String or Array of Strings | \n Hook name, for example 'save'. Or an array of names, see example below. | \n Yes | \n
\n \n method | \n Function | \n Callback to be executed after all before hooks finished execution successfully. options is passed as first argument | \n Yes | \n
\n \n options | \n Object | \n Will be passed to all before hooks as reference, so they can mutate it | \n No, defaults to empty object ({}) | \n
\n
\n\nResolves with whatever `method` returns or resolves with.\nRejects with error that is thrown or rejected with by\n\n1. Any of the before hooks, whichever rejects / throws first\n2. `method`\n3. Any of the after hooks, whichever rejects / throws first\n\nSimple Example\n\n```js\nhookCollection(\n \"save\",\n (record) => {\n return store.save(record);\n },\n record\n);\n// shorter: hookCollection('save', store.save, record)\n\nhookCollection.before(\"save\", function addTimestamps(record) {\n const now = new Date().toISOString();\n if (record.createdAt) {\n record.updatedAt = now;\n } else {\n record.createdAt = now;\n }\n});\n```\n\nExample defining multiple hooks at once.\n\n```js\nhookCollection(\n [\"add\", \"save\"],\n (record) => {\n return store.save(record);\n },\n record\n);\n\nhookCollection.before(\"add\", function addTimestamps(record) {\n if (!record.type) {\n throw new Error(\"type property is required\");\n }\n});\n\nhookCollection.before(\"save\", function addTimestamps(record) {\n if (!record.type) {\n throw new Error(\"type property is required\");\n }\n});\n```\n\nDefining multiple hooks is helpful if you have similar methods for which you want to define separate hooks, but also an additional hook that gets called for all at once. The example above is equal to this:\n\n```js\nhookCollection(\n \"add\",\n (record) => {\n return hookCollection(\n \"save\",\n (record) => {\n return store.save(record);\n },\n record\n );\n },\n record\n);\n```\n\n### hookCollection.before()\n\nAdd before hook for given name.\n\n```js\nhookCollection.before(name, method);\n```\n\n