When emitting custom events with data using `$emit`, pass an object literal as the payload instead of a raw primitive value, especially if there's a chance more data might be needed later.
Passing an object payload makes the event emission more extensible. If you later need to add more data to the event, you can add new properties to the object without breaking existing listeners expecting a specific primitive type. It improves the maintainability and future-proofing of component communication.
Side-by-side examples engineers can pattern-match during review.
// BAD: Emitting a raw value
this.$emit('item-selected', itemId);
// Listener might break if we later change to emit an object:
// handleItemSelected(itemId) { /*... */ }// GOOD: Emitting an object payload
this.$emit('item-selected', {
itemId: itemId,
itemType: 'product'
});
// Listener is more robust:
// handleItemSelected(payload) {
// console.log(payload.itemId, payload.itemType);
// }this.$emit('user-updated', userId);this.$emit('user-updated', { userId: userId, status: 'active' });From the same buckets as this rule.