Simple lightweight string operation library for Typescript.

Installation

npm install typescript-string-operations

No jQuery required! Unit tested, works with Angular.

 import { StringBuilder, emptyString, joinString, formatString, isNullOrWhiteSpace } from 'typescript-string-operations';

When migrating from Version 1.4.1 or lower, you can also import the class String. Using this String class would override the native String object from JavaScript. We will remove this declaration with the next major release

 import { String } from 'typescript-string-operations';

USAGE:

String.empty

var id = emptyString; // or String.empty
// output: id = '';

String.isNullOrWhiteSpace():

var id = image.GetId();
if(isNullOrWhiteSpace(id)) // String.isNullOrWhiteSpace(id)
    return image;

String.format():

var id = image.GetId()
formatString("image_{0}.jpg", id) // or String.format()
output: "image_2db5da20-1c5d-4f1a-8fd4-b41e34c8c5b5.jpg";

Specifier available!

var value = formatString("{0:L}", "APPLE"); //output "apple"

value = formatString("{0:U}", "apple"); // output "APPLE"

value = formatString("{0:d}", "2017-01-23 00:00"); //output "23.01.2017"

value = formatString("{0:s}", "21.03.2017 22:15:01") //output "2017-03-21T22:15:01"

value = formatString("{0:n}", 1000000);
//output "1.000.000"

value = formatString("{0:00}", 1);
//output "01"

UPDATE

String.format for Objects including specifiers

var fruit = new Fruit();
fruit.type = "apple";
fruit.color = "RED";
fruit.shippingDate = new Date(2018, 1, 1);
fruit.amount = 10000;

format("the {type:U} is {color:L} shipped on {shippingDate:s} with an amount of {amount:n}", fruit);
// output: the APPLE is red shipped on 2018-01-01 with an amount of 10.000

String.join():

var value = joinString("; ", "Apple", "Banana"); // or String.join()
//output: "Apple; Banana";

OR

 let object = { Name: "Foo", Value: "Bar" };
 var value = joinString('.', object);
//output: "Foo.Bar";

var array = ['Apple', 'Banana']
var value = joinString("; ", array);
//output: "Apple; Banana";

Methods

StringBuilder

Just like you know from C#,

var favoriteFruit: string = this.fruitService.getFavorite(); //Blueberries

var builder = new StringBuilder("My favorite fruits are: ");
builder.Append("Apples, ");
builder.Append("Bananas ");

// using String.format() internally
builder.AppendFormat("and especially {0:U}!", favoriteFruit);
builder.AppendFormat(" I eat {0} every day!", 10);

var fruits = builder.ToString();

//output: "My favorite fruits are: Apples, Bananas and especially BLUEBERRIES! I eat 10 every day!";

Methods

CHANGELOG

1.6.0

• Using latest typescript version, please check if your environment still works with this version before upgrading!
• chore: upgraded packages
• chore: migrated eslint to 9.x

1.5.0

• Using latest typescript version, please check if your environment still works with this version before upgrading!
• feature: !IMPORTANT methods/properties starting with uppercase are marked deprecated now and will be removed in future versions! Check the deprecated infos
• feature: String.isNullOrWhiteSpace accepts null or undefined now
• feature: added new methods/properties: isNullOrWhiteSpace(), formatString(), joinString(), empty, check README
• chore: Updated packages
• chore: added linting

1.4.1

• docs: added missing docs for AppendLine and AppendLineFormat
• bufix: fixed circleci badge

1.4.0

• feature: added AppendLine and AppendLineFormat
• feature: added hexadecimal conversion specifier
• bugfix: StringBuilder initialization without parameter adds empty string to internal Values Array.
• bugfix: When there is no placeholder in the template passed to String.format it should return the original template