string-object-formatter

Python inspired named template formatter for Javascript strings

Usage no npm install needed!

<script type="module">
  import stringObjectFormatter from 'https://cdn.skypack.dev/string-object-formatter';
</script>

README

string-object-formatter

Inspired by python named formatter function, replace text inside a string based on object properties names and values.

Example usage

Import it in your code

In a CommonJS environment

const Formatter = require('string-object-formatter');

Using import

import Formatter from 'string-object-formatter';

Default delimiters

const formatter = new Formatter(#);
const toFormat = 'My name is {firstName} {lastName}';
const formatted = formatter.format(toFormat, {
  firstName: 'John',
  lastName: 'Doe',
});

// formatted is 'My name is John Doe'

Custom delimiters

const formatter = new Formatter('{{', '}}');
const toFormat = 'My name is {{firstName}} {{lastName}}';
const formatted = formatter.format(toFormat, {
  firstName: 'John',
  lastName: 'Doe',
});

// formatted is 'My name is John Doe'

Table of contents

Constructors

Properties

Methods

Constructors

constructor

+ new default(startDelimiter?: string, endDelimiter?: string): default

Creates an instance of Formatter.

memberof Formatter

Parameters:

Name Type Default value
startDelimiter string '{'
endDelimiter string '}'

Returns: default

Defined in: index.ts:12

Properties

endDelimiter

endDelimiter: string

Defined in: index.ts:12


startDelimiter

startDelimiter: string

Defined in: index.ts:11

Methods

format

format(stringToFormat: string, formatItems: FormatObject): string

Formats string according to object

memberof Formatter

Parameters:

Name Type Description
stringToFormat string The string to format
formatItems FormatObject Ex.: {'toReplace': 'replaced'} turns 'example_{toReplace}' to 'example_replaced'

Returns: string

The replaced string

Defined in: index.ts:36