Function transform

transform<Input = any, Output = Input>(
value: Input,
valueTransformer?: TransformFunc,
): Output

This method creates a clone of the given value. and allows customization of the value by a valueTransformer function.

By default this works only for flat objects and not for objects which are instances of classes. But a valueTransformer is able to transform input classes to target classes or keep them as is.

Note: Cycles in value are not supported for now.

Type Parameters

Input = any
Output = Input

Parameters

value: Input
valueTransformer: TransformFunc = ...

Returns Output

Example: simple clone

import {transform} from "apprt-core/clone";
const input = { x: 1, c: {a: 1} };
const copyOfInput = transform(input);

Example: transformation

import {transform} from "apprt-core/clone";
const input = { x: 1, c: { a: 1 } };
const transformedCopy = transform(input, (value, ctx) => {
    if (ctx.path[ctx.path.length - 1] === "c") {
        // value is { a: 1 }
        // change c to be a number
        return value.a;
    }
    return value;
});
// -> transformedCopy === { x: 1, c: 1 }