CompressPresets Overview
Complete Preset List
disabled
Disable compression
default
Default settings (1KB, br/gzip/deflate)
aggressive
Aggressive compression (256B)
conservative
Conservative compression (4KB, gzip only)
gzipOnly
gzip only
Preset Details
disabled
Completely disables compression.- Configuration
- When to Use
- Example
default
Balanced default settings.- Configuration
- When to Use
- Example
- Under 1KB: No compression (prevents overhead)
- 1KB and above: Compression in order of brotli > gzip > deflate
- Modern browsers: brotli (best compression ratio)
- Legacy browsers: gzip (compatibility)
aggressive
Aggressive compression for bandwidth optimization.- Configuration
- When to Use
- Example
- Compresses everything 256 bytes and above
- Minimizes network transfer volume
- Slight increase in CPU overhead
conservative
Conservative compression that minimizes CPU load.- Configuration
- When to Use
- Example
- Under 4KB: No compression
- Excludes brotli (saves CPU)
- Uses gzip only (fast + compatible)
gzipOnly
Configuration that uses only gzip.- Configuration
- When to Use
- Example
- Fastest compression
- Supported by all browsers
- Stable
Preset Comparison Table
| Preset | Threshold | Algorithms | CPU Usage | Compression Ratio | Use Case |
|---|---|---|---|---|---|
disabled | - | None | Minimal | 0% | Development, already compressed content |
default | 1KB | br/gzip/deflate | Medium | High | General cases (recommended) |
aggressive | 256B | br/gzip/deflate | High | Best | Bandwidth optimization |
conservative | 4KB | gzip/deflate | Low | Medium | CPU saving, high performance |
gzipOnly | 1KB | gzip | Low | Medium | Legacy support, stability |
Compression Ratio Comparison
Based on actual 100KB JSON data:| Algorithm | Compressed Size | Compression Ratio | Speed |
|---|---|---|---|
| No compression | 100KB | 0% | - |
| deflate | 15KB | 85% | Fast |
| gzip | 14KB | 86% | Fast |
| brotli (br) | 12KB | 88% | Slow |
Recommended Presets by Scenario
Production API Server
Mobile App Backend
High-Performance Real-Time API
Legacy Browser Support
Development Environment
Combining Presets
You can customize based on presets.Per-API Presets
Environment-Based Presets
Precautions
Performance Measurement
Performance comparison by preset (based on 100KB JSON):| Preset | Compression Time | Compressed Size | Network | Total Time |
|---|---|---|---|---|
disabled | 0ms | 100KB | 1000ms | 1000ms |
gzipOnly | 2ms | 14KB | 140ms | 142ms |
conservative | 2ms | 14KB | 140ms | 142ms |
default | 5ms | 12KB | 120ms | 125ms |
aggressive | 5ms | 12KB | 120ms | 125ms |