TTL configuration in NestJS - Performance & Optimization

Performance: TTL configuration

MEDIUM IMPACT

TTL configuration affects how long cached data stays valid, impacting page load speed and server response times by controlling cache freshness.

Setting cache expiration for API responses

NestJS

cacheManager.set('key', data, { ttl: 60 }); // cache expires after 60 seconds

Cache clears regularly, ensuring fresh data and controlled memory use, improving response speed.

📈 Performance GainReduces server load and memory pressure, improving LCP by serving fresh cached content.

Setting cache expiration for API responses

NestJS

cacheManager.set('key', data, { ttl: 0 }); // no expiration, cache never clears

Cache never expires, causing stale data and increased memory use, slowing server response over time.

📉 Performance CostIncreases memory usage and can block server response, indirectly delaying LCP.

Performance Comparison

Pattern	Cache Freshness	Memory Usage	Server Load	Verdict
No TTL (cache never expires)	Stale data	High	High	[X] Bad
Short TTL (e.g., 60 seconds)	Fresh data	Controlled	Low	[OK] Good

Rendering Pipeline

TTL configuration controls cache validity, affecting whether data is served from cache or requires server processing, influencing the critical rendering path.

→Server Processing

→Network

→Rendering

⚠️ BottleneckServer Processing when cache is stale or missing

Core Web Vital Affected

LCP

TTL configuration affects how long cached data stays valid, impacting page load speed and server response times by controlling cache freshness.

Optimization Tips

1Set TTL to balance data freshness and cache hit rate.

2Avoid TTL=0 to prevent stale data and memory bloat.

3Use TTL to reduce server processing and improve LCP.

Performance Quiz - 3 Questions

How does setting a proper TTL value affect server response times?

A It reduces server processing by serving cached data when valid.

B It increases server load by forcing frequent cache refreshes.

C It has no impact on server response times.

D It always causes stale data to be served.

DevTools: Network

How to check: Open DevTools > Network tab, inspect API response headers for cache-control or custom TTL headers, and observe response times.

What to look for: Look for cache hits vs misses and response time improvements indicating effective TTL usage.

Practice

1. What does TTL stand for in NestJS caching configuration?

easy

A. Timed Token Lock, a security feature for cache access

B. Time To Live, the duration cached data stays before removal

C. Temporary Transfer Lock, a pause on cache updates

D. Total Transaction Limit, the max number of cache writes

Solution

1. Step 1: Understand TTL meaning in caching

   TTL means how long cached data remains valid before it is removed automatically.

2. Step 2: Match TTL to the correct full form

   TTL stands for Time To Live, which fits the caching context perfectly.

3. Final Answer:

   Time To Live, the duration cached data stays before removal -> Option B

4. Quick Check:

   TTL = Time To Live [OK]

Hint: TTL means how long cache data lives before removal [OK]

Common Mistakes:

• Confusing TTL with security or transaction terms
• Thinking TTL is a cache size limit
• Assuming TTL is a manual cache clear command

2. Which is the correct way to set a global TTL of 10 seconds in NestJS cache module?

easy

A. CacheModule.register({ ttl: 10 })

B. CacheModule.register({ timeToLive: 10 })

C. CacheModule.register({ ttl: 10000 })

D. CacheModule.register({ expire: 10 })

Solution

1. Step 1: Identify TTL unit in NestJS cache config

   TTL is set in seconds, so 10 means 10 seconds.

2. Step 2: Check correct property name and value type

   The property is ttl, and the value is a number in seconds, so ttl: 10 is correct.

3. Final Answer:

   CacheModule.register({ ttl: 10 }) -> Option A

4. Quick Check:

   TTL in seconds uses 'ttl' property [OK]

Hint: TTL value is seconds, use 'ttl' property exactly [OK]

Common Mistakes:

• Using milliseconds instead of seconds
• Using wrong property names like timeToLive or expire
• Passing ttl as string instead of number

3. Given this NestJS cache config snippet:

CacheModule.register({ ttl: 5 })

What happens to cached data after 6 seconds?

medium

A. Cached data throws an error after 6 seconds

B. Cached data remains indefinitely until manually cleared

C. Cached data is refreshed automatically every 6 seconds

D. Cached data is automatically removed after 5 seconds

Solution

1. Step 1: Understand TTL effect on cached data

   TTL of 5 means cached data expires and is removed after 5 seconds.

2. Step 2: Check what happens after 6 seconds

   Since 6 seconds is more than 5, cached data is no longer valid and is removed.

3. Final Answer:

   Cached data is automatically removed after 5 seconds -> Option D

4. Quick Check:

   TTL 5 seconds means removal after 5 seconds [OK]

Hint: Data expires after TTL seconds, so 6 > 5 means removal [OK]

Common Mistakes:

• Thinking data stays forever without manual clear
• Assuming TTL refreshes cache automatically
• Believing cache throws errors on expiry

4. Identify the error in this NestJS cache TTL setup:

CacheModule.register({ ttl: '30' })

medium

A. TTL property name is incorrect, should be timeToLive

B. TTL cannot be set globally, only per item

C. TTL value should be a number, not a string

D. TTL value must be in milliseconds, not seconds

Solution

1. Step 1: Check TTL value type

   TTL expects a number representing seconds, but '30' is a string.

2. Step 2: Confirm correct property and units

   The property ttl is correct and uses seconds, so only the value type is wrong.

3. Final Answer:

   TTL value should be a number, not a string -> Option C

4. Quick Check:

   TTL must be numeric seconds, not string [OK]

Hint: TTL must be a number, not quoted string [OK]

Common Mistakes:

• Using string instead of number for TTL
• Changing property name incorrectly
• Confusing seconds with milliseconds

5. You want to cache user data with a TTL of 60 seconds, but override it to 120 seconds for admin users only. How do you configure TTL in NestJS?

hard

A. Set global TTL to 60, then use @CacheTTL(120) decorator on admin methods

B. Set global TTL to 120, then manually clear cache for non-admin users

C. Set TTL only in controller constructor based on user role

D. Use two separate CacheModules with different TTLs and switch dynamically

Solution

1. Step 1: Set global TTL for general users

   Configure CacheModule with ttl: 60 to cover normal users.

2. Step 2: Override TTL for admin users

   Use the @CacheTTL(120) decorator on admin-specific methods to extend TTL.

3. Final Answer:

   Set global TTL to 60, then use @CacheTTL(120) decorator on admin methods -> Option A

4. Quick Check:

   Global TTL + @CacheTTL override [OK]

Hint: Use global TTL plus @CacheTTL decorator for overrides [OK]

Common Mistakes:

• Trying to set TTL only in constructor without decorators
• Using multiple CacheModules unnecessarily
• Setting global TTL too high and clearing cache manually