556
Bn
bees-nest / files
bees-nest / .opencode / skills / vercel-react-best-practices / rules / async-defer-await.md
2.0 KB
1--- 2title: Defer Await Until Needed 3impact: HIGH 4impactDescription: avoids blocking unused code paths 5tags: async, await, conditional, optimization 6--- 7 8## Defer Await Until Needed 9 10Move `await` operations into the branches where they're actually used to avoid blocking code paths that don't need them. 11 12**Incorrect (blocks both branches):** 13 14```typescript 15async function handleRequest(userId: string, skipProcessing: boolean) { 16 const userData = await fetchUserData(userId) 17 18 if (skipProcessing) { 19 // Returns immediately but still waited for userData 20 return { skipped: true } 21 } 22 23 // Only this branch uses userData 24 return processUserData(userData) 25} 26``` 27 28**Correct (only blocks when needed):** 29 30```typescript 31async function handleRequest(userId: string, skipProcessing: boolean) { 32 if (skipProcessing) { 33 // Returns immediately without waiting 34 return { skipped: true } 35 } 36 37 // Fetch only when needed 38 const userData = await fetchUserData(userId) 39 return processUserData(userData) 40} 41``` 42 43**Another example (early return optimization):** 44 45```typescript 46// Incorrect: always fetches permissions 47async function updateResource(resourceId: string, userId: string) { 48 const permissions = await fetchPermissions(userId) 49 const resource = await getResource(resourceId) 50 51 if (!resource) { 52 return { error: 'Not found' } 53 } 54 55 if (!permissions.canEdit) { 56 return { error: 'Forbidden' } 57 } 58 59 return await updateResourceData(resource, permissions) 60} 61 62// Correct: fetches only when needed 63async function updateResource(resourceId: string, userId: string) { 64 const resource = await getResource(resourceId) 65 66 if (!resource) { 67 return { error: 'Not found' } 68 } 69 70 const permissions = await fetchPermissions(userId) 71 72 if (!permissions.canEdit) { 73 return { error: 'Forbidden' } 74 } 75 76 return await updateResourceData(resource, permissions) 77} 78``` 79 80This optimization is especially valuable when the skipped branch is frequently taken, or when the deferred operation is expensive.