each-props

WebJar for each-props

License	MIT
GroupId	org.webjars.npm
ArtifactId	each-props
Last Version	1.3.2
Release Date	Mar 25, 2019
Type	jar
Description	each-props WebJar for each-props
Project URL	http://webjars.org
Source Code Management	https://github.com/sttk/each-props

Download each-props

Filename	Size
each-props-1.3.2.pom
each-props-1.3.2.jar	6 KB
each-props-1.3.2-sources.jar	22 bytes
each-props-1.3.2-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/each-props/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>each-props</artifactId>
    <version>1.3.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/each-props/
implementation 'org.webjars.npm:each-props:1.3.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/each-props/
implementation ("org.webjars.npm:each-props:1.3.2")

Apache Buildr

'org.webjars.npm:each-props:jar:1.3.2'

Apache Ivy

<dependency org="org.webjars.npm" name="each-props" rev="1.3.2">
  <artifact name="each-props" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='each-props', version='1.3.2')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "each-props" % "1.3.2"

Leiningen

[org.webjars.npm/each-props "1.3.2"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.webjars.npm : is-plain-object	jar	[2.0.1,3)
org.webjars.npm : object.defaults	jar	[1.1.0,2)

Project Modules

There are no modules declared in this project.

each-props

Processes each properties of an object deeply.

Install

To install from npm:

$ npm i each-props --save

Load this module

For Node.js:

const eachProps = require('each-props');

For Web browser:

<script src="each-props.min.js"></script>

Usage

Apply a function to all (non plain object) properties.

var obj = { a: 1, b: { c: 'CCC', d: { e: 'EEE' } } };

eachProps(obj, function(value, keyChain, nodeInfo) {
  if (keyChain === 'a') {
    nodeInfo.parent['a'] = value * 2;
  } else if (keyChain === 'b.c') {
    nodeInfo.parent['c'] = value.toLowerCase();
  } else if (keyChain === 'b.d') {
    return true; // stop to dig
  } else if (keyChain === 'b.d.e') {
    nodeInfo.parent['e'] = value.toLowerCase();
  }
});

console.log(obj);
// => { a: 2, b: { c: 'ccc', d: { e: 'EEE' } } };

API

eachProps(obj, fn [, opts]) : void

Executes the fn function for all properties.

Parameters:

Parameter	Type	Description
obj	object	A plain object to be treated.
fn	function	A function to operate each properties.
opts	object	An object to pass any data to each properties.

• API of fn function

  fn(value, keyChain, nodeInfo) : boolean

  This function is applied to all properties in an object.

  Parameters:

  Parameter	Type	Description
  value	any	A property value.
  keyChain	string	A string concatenating the hierarchical keys with dots.
  nodeInfo	object	An object which contains node informations (See below).

  Returns:

  True, if stops digging child properties.

  Type: boolean

• Properties of nodeInfo

  Properties	Type	Description
  name	string	The property name of this node.
  index	number	The index of the property among the sibling properties.
  count	number	The count of the sibling properties.
  depth	number	The depth of the property.
  parent	object	The parent node of the property.
  sort	function	A sort function which orders the child properties. This function is inherited from opts, if be specified.

  ... and any properties inherited from opts.

• Properties of opts

  Properties	Type	Description
  sort	function	A sort function which orders the same level properties. (Optional)

  ... and any properties you want to pass to each node.

License

Copyright (C) 2016-2020 Gulp Team.

This program is free software under MIT License. See the file LICENSE in this distribution for more details.

Versions

Version
1.3.2 Mar 25, 2019