123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199 |
- interface TraverseOptions {
- /**
- * If true, does not alter the original object
- */
- immutable?: boolean;
- /**
- * If false, removes all symbols from traversed objects
- *
- * @default false
- */
- includeSymbols?: boolean;
- }
- interface TraverseContext {
- /**
- * The present node on the recursive walk
- */
- node: any;
- /**
- * An array of string keys from the root to the present node
- */
- path: PropertyKey[];
- /**
- * The context of the node's parent.
- * This is `undefined` for the root node.
- */
- parent: TraverseContext | undefined;
- /**
- * The contexts of the node's parents.
- */
- parents: TraverseContext[];
- /**
- * The name of the key of the present node in its parent.
- * This is `undefined` for the root node.
- */
- key: PropertyKey | undefined;
- /**
- * Whether the present node is the root node
- */
- isRoot: boolean;
- /**
- * Whether the present node is not the root node
- */
- notRoot: boolean;
- /**
- * Whether the present node is the last node
- */
- isLast: boolean;
- /**
- * Whether the present node is the first node
- */
- isFirst: boolean;
- /**
- * Whether or not the present node is a leaf node (has no children)
- */
- isLeaf: boolean;
- /**
- * Whether or not the present node is not a leaf node (has children)
- */
- notLeaf: boolean;
- /**
- * Depth of the node within the traversal
- */
- level: number;
- /**
- * If the node equals one of its parents, the `circular` attribute is set to the context of that parent and the traversal progresses no deeper.
- */
- circular: TraverseContext | undefined;
- /**
- * Set a new value for the present node.
- *
- * All the elements in `value` will be recursively traversed unless `stopHere` is true (false by default).
- */
- update(value: any, stopHere?: boolean): void;
- /**
- * Remove the current element from the output. If the node is in an Array it will be spliced off. Otherwise it will be deleted from its parent.
- */
- remove(stopHere?: boolean): void;
- /**
- * Delete the current element from its parent in the output. Calls `delete` even on Arrays.
- */
- delete(stopHere?: boolean): void;
- /**
- * Object keys of the node.
- */
- keys: PropertyKey[] | null;
- /**
- * Call this function before all of the children are traversed.
- * You can assign into `this.keys` here to traverse in a custom order.
- */
- before(callback: (this: TraverseContext, value: any) => void): void;
- /**
- * Call this function after all of the children are traversed.
- */
- after(callback: (this: TraverseContext, value: any) => void): void;
- /**
- * Call this function before each of the children are traversed.
- */
- pre(callback: (this: TraverseContext, child: any, key: any) => void): void;
- /**
- * Call this function after each of the children are traversed.
- */
- post(callback: (this: TraverseContext, child: any) => void): void;
- /**
- * Stops traversal entirely.
- */
- stop(): void;
- /**
- * Prevents traversing descendents of the current node.
- */
- block(): void;
- }
- /** @deprecated Import `Traverse` from `neotraverse/modern` instead */
- declare class Traverse {
- #private;
- constructor(obj: any, options?: TraverseOptions);
- /**
- * Get the element at the array `path`.
- */
- get(paths: PropertyKey[]): any;
- /**
- * Return whether the element at the array `path` exists.
- */
- has(paths: PropertyKey[]): boolean;
- /**
- * Set the element at the array `path` to `value`.
- */
- set(path: PropertyKey[], value: any): any;
- /**
- * Execute `fn` for each node in the object and return a new object with the results of the walk. To update nodes in the result use `this.update(value)`.
- */
- map(cb: (this: TraverseContext, v: any) => void): any;
- /**
- * Execute `fn` for each node in the object but unlike `.map()`, when `this.update()` is called it updates the object in-place.
- */
- forEach(cb: (this: TraverseContext, v: any) => void): any;
- /**
- * For each node in the object, perform a [left-fold](http://en.wikipedia.org/wiki/Fold_(higher-order_function)) with the return value of `fn(acc, node)`.
- *
- * If `init` isn't specified, `init` is set to the root object for the first step and the root element is skipped.
- */
- reduce(cb: (this: TraverseContext, acc: any, v: any) => void, init?: any): any;
- /**
- * Return an `Array` of every possible non-cyclic path in the object.
- * Paths are `Array`s of string keys.
- */
- paths(): PropertyKey[][];
- /**
- * Return an `Array` of every node in the object.
- */
- nodes(): any[];
- /**
- * Create a deep clone of the object.
- */
- clone(): any;
- }
- declare const traverse: {
- (obj: any, options?: TraverseOptions): Traverse;
- /**
- * Get the element at the array `path`.
- */
- get(obj: any, paths: PropertyKey[], options?: TraverseOptions): any;
- /**
- * Set the element at the array `path` to `value`.
- */
- set(obj: any, path: PropertyKey[], value: any, options?: TraverseOptions): any;
- /**
- * Return whether the element at the array `path` exists.
- */
- has(obj: any, paths: PropertyKey[], options?: TraverseOptions): boolean;
- /**
- * Execute `fn` for each node in the object and return a new object with the results of the walk. To update nodes in the result use `this.update(value)`.
- */
- map(obj: any, cb: (this: TraverseContext, v: any) => void, options?: TraverseOptions): any;
- /**
- * Execute `fn` for each node in the object but unlike `.map()`, when `this.update()` is called it updates the object in-place.
- */
- forEach(obj: any, cb: (this: TraverseContext, v: any) => void, options?: TraverseOptions): any;
- /**
- * For each node in the object, perform a [left-fold](http://en.wikipedia.org/wiki/Fold_(higher-order_function)) with the return value of `fn(acc, node)`.
- *
- * If `init` isn't specified, `init` is set to the root object for the first step and the root element is skipped.
- */
- reduce(obj: any, cb: (this: TraverseContext, acc: any, v: any) => void, init?: any, options?: TraverseOptions): any;
- /**
- * Return an `Array` of every possible non-cyclic path in the object.
- * Paths are `Array`s of string keys.
- */
- paths(obj: any, options?: TraverseOptions): PropertyKey[][];
- /**
- * Return an `Array` of every node in the object.
- */
- nodes(obj: any, options?: TraverseOptions): any[];
- /**
- * Create a deep clone of the object.
- */
- clone(obj: any, options?: TraverseOptions): any;
- };
- export { type TraverseContext, type TraverseOptions, traverse as default };
|