afterInsert( )
A hook that is triggered after an insert()
operation.
Description
The afterInsert()
hook runs when:
- The
insert()
function is called. - An action is performed on a dataset that inserts a new item into the collection.
- An item is inserted using the Content Manager.
- An item is imported into the Sandbox or Live collection.
Return an object or a Promise that resolves to an object from the afterInsert()
function. The returned object will be used as the result of the call to the
insert()
function instead of the actual item inserted
into the collection. If returning a Promise, the object is used as the result,
whether the Promise is fulfilled or rejected.
If the returned value is of the wrong type, the value is ignored.
A rejected Promise also calls the onFailure()
hook if it has
been registered.
Because the afterInsert
hook is called after the insert()
is executed, it cannot affect the item that is inserted into the collection.
It can only affect the item returned by insert()
.
Authorization
Request
This endpoint does not take any parameters
Response Object
The item to return to insert()
instead of the inserted item.
Returning a rejected promise will not block the operation, but will return a rejected promise to the caller as well as trigger the onFailure()
hook.
Returns an empty object.
Status/Error Codes
Was this helpful?
1// In data.js23export function myCollection_afterInsert(item, context) {4 let hookContext = context; // see below56 // some changes to the received item78 return item;9}1011/*12 * hookContext:13 *14 * {15 * "collectionName": "myCollection",16 * "userId": "f45jf8d2-grkj-2opd-4ovk-9rfj4wo5tvj3",17 * "userRole": "siteOwner"18 * }19 */
insert()
using an afterInsert hook1// In data.js23export function myCollection_afterInsert(item, context) {4 let hookContext = context; // see below56 //add a new property to the item being returned that aggregates the content from several fields into one7 item.combinedSentence = `Customer: ${item.lastName}, ${item.firstName}: Purchases: ${item.purchases}, Item Returns: ${item.returns}`;89 return item;10}1112/*13 * hookContext:14 *15 * {16 * "collectionName": "myCollection",17 * "userId": "f45jf8d2-grkj-2opd-4ovk-9rfj4wo5tvj3",18 * "userRole": "siteOwner"19 * }20 */