Query parameters in NestJS - Performance & Optimization

Performance: Query parameters

MEDIUM IMPACT

Query parameters affect how the server processes requests and can impact response time and payload size, indirectly influencing page load speed.

Handling user filters via query parameters in a NestJS API

NestJS

import { Controller, Get, Query } from '@nestjs/common';
import { IsOptional, IsString, IsInt } from 'class-validator';

class ItemQueryDto {
  @IsOptional()
  @IsString()
  category?: string;

  @IsOptional()
  @IsInt()
  limit?: number;
}

@Controller('items')
export class ItemsController {
  @Get()
  getItems(@Query() query: ItemQueryDto) {
    // Validated and typed query parameters
    return this.itemsService.find(query);
  }
}

Validating and typing query parameters reduces unnecessary data processing and prevents large, malformed queries, improving server response time.

📈 Performance GainReduces server processing time by 30-50% on average and lowers payload size, improving LCP.

Handling user filters via query parameters in a NestJS API

NestJS

import { Controller, Get, Query } from '@nestjs/common';

@Controller('items')
export class ItemsController {
  @Get()
  getItems(@Query() query: any) {
    // Accepts all query params without validation
    return this.itemsService.find(query);
  }
}

Accepting all query parameters without validation can lead to large, unoptimized queries causing slow database responses and increased payload size.

📉 Performance CostIncreases server processing time and response size, potentially blocking rendering for 100+ ms on complex queries.

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Unvalidated large query params	N/A (server-side)	N/A	Increases due to delayed response	[X] Bad
Validated, minimal query params	N/A (server-side)	N/A	Lower due to faster response	[OK] Good

Rendering Pipeline

Query parameters are parsed by the server before generating the response. Large or complex queries increase server processing time, delaying the HTML response and thus the browser's rendering start.

→Server Processing

→Network Transfer

→Rendering Start

⚠️ BottleneckServer Processing

Core Web Vital Affected

LCP

Query parameters affect how the server processes requests and can impact response time and payload size, indirectly influencing page load speed.

Optimization Tips

1Validate and type query parameters to avoid unnecessary server processing.

2Keep query parameters minimal and relevant to reduce payload size.

3Avoid sending large or complex data in query parameters to improve response time.

Performance Quiz - 3 Questions

How do large, unvalidated query parameters affect page load performance?

A They reduce the size of the HTML response.

B They increase server processing time and delay content rendering.

C They improve browser caching efficiency.

D They have no impact on performance.

DevTools: Network

How to check: Open DevTools, go to Network tab, filter by XHR or Fetch, inspect request URLs and response times for requests with query parameters.

What to look for: Look for long server response times and large payload sizes indicating inefficient query parameter usage.