lowercase

transformers

Source Code | Documentation

Transforms the specified fields of an item to lowercase.

  import {  } from 'feathers-utils/transformers';

Example

import { transformData, lowercase } from 'feathers-utils/transformers'

transformData(item => lowercase(item, 'email'))

Hooks for transformers

Hook	Description
transformData	Transforms each item in context.data using the provided transformer function. The transformer receives each item and can mutate it in place or return a new object. Commonly used with built-in transformers like lowercase, trim, or setNow.
transformQuery	Transforms context.params.query using the provided transformer function. The transformer receives the current query and can return a modified version. Useful for normalizing, sanitizing, or enriching queries before they hit the database.
transformResult	Transforms each item in context.result using the provided transformer function. The transformer receives each item and can mutate it in place or return a new object. Optionally operates on context.dispatch via the dispatch option.

Utilities for transformers

Utility	Description
mutateData	Applies a transformer function to each item in context.data, updating it in place. If the transformer returns a new object, it replaces the original item. Correctly handles both single-item and array data, preserving the original shape.
mutateResult	Applies a transformer function to each item in context.result (and optionally context.dispatch). Handles paginated results, single items, and arrays transparently. Use the dispatch option to control whether result, dispatch, or both are transformed.

Type declaration

Show Type Declarations

/**
 * Transforms the specified fields of an item to lowercase.
 *
 * @example
 * ```ts
 *
 *
 * transformData(item => lowercase(item, 'email'))
 * ```
 *
 * @see https://utils.feathersjs.com/transformers/lowercase.html
 */
export declare function lowercase<T extends Record<string, any>>(
  item: T,
  fieldNames: MaybeArray<StringFieldKey<NoInfer<T>>>,
): void

Argument	Type	Description
item	T
fieldNames	MaybeArray<StringFieldKey<NoInfer<T>>>