Skip to content

nathan818fr/node-java-props

Repository files navigation

java-props

npm version TypeScript Build Status codecov

Read/Parse Java .properties files (using EXACTLY the same specification) in Javascript (browser) and Node.js.

This module provides its own TypeScript declarations (.d.ts).

Installation

npm install java-props

Example

# file.properties
a = Hello World
b : Node.js\u00AE
c value
d=foo\
  bar
const javaProps = require('java-props');

javaProps
    .parseFile('./file.properties')
    .then((props) => {
        console.log(props);
        // { a: 'Hello World', b: 'Node.js®', c: 'value', d: 'foobar' }
    })
    .catch((err) => {
        console.error(err);
    });

Documentation

For a detailed API reference, see: node-java-props.nathan818.fr

Building

This project uses TypeScript. To create javascript sources run:

yarn run build

Testing

To run the test suite, first install the dependencies, then run yarn test:

yarn install
yarn test

Contributing

Contributions are welcome.

The goal is to keep a simple project without unnecessary (non essential) features. It is recommended to open an issue before introducing new features to discuss them.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

License

This project is licensed under the MIT License. See the LICENSE file for details.