@studnicky/require-options-object

When a function or method has two or more caller-omittable parameter slots, they must be collected into a single trailing options object. The threshold defaults to minimumOptionals: 2 and is configurable. The rule counts ? parameters, defaulted parameters, parameters typed T | undefined, and optional members of a rest tuple. It applies to function declarations, function expressions, arrow functions, and TypeScript call, construct, function, and method signatures.

Fixable: No · Options: minimumOptionals · Suggested severity: error

✗ Incorrect

// Two optional parameters — collect into options object
function fetch(url: string, timeout?: number, retries?: number): Promise<Response> {
  /* ... */
}

// Three optional parameters on a method
class HttpClient {
  request(url: string, method?: string, body?: string, signal?: AbortSignal): Promise<Response> {
    /* ... */
  }
}

✓ Correct

// Collected into a trailing options object
function fetch(url: string, opts?: { timeout?: number; retries?: number }): Promise<Response> {
  /* ... */
}

// Method with options object
class HttpClient {
  request(url: string, opts?: { method?: string; body?: string; signal?: AbortSignal }): Promise<Response> {
    /* ... */
  }
}

Options

{
  "@studnicky/require-options-object": ["error", { "minimumOptionals": 2 }]
}

Option	Type	Default	Description
minimumOptionals	integer	2	Minimum number of caller-omittable parameter slots before an options object is required. Minimum value is 2.