js-extensions v1.0.6

Classes

• Object
  • new Object()
  • .values(obj) ⇒ Object
  • .clone(obj) ⇒ Object
  • .equals(obj, other) ⇒ boolean
  • .hashCode(obj) ⇒ int
  • .isNullOrUndefined(obj) ⇒ boolean
  • .merge(params) ⇒ *

new Object()

Placeholder for native Object class. The methods below are extension methods.

Object.values(obj) ⇒ Object

Returns an array of values of a given object's own enumerable properties, in the same order as that provided by a for...in loop.

Kind: static method of Object
Returns: Object - The array of property values.

Object.clone(obj) ⇒ Object

Makes a deep copy of an object

Kind: static method of Object
Returns: Object - The cloned object.

Object.equals(obj, other) ⇒ boolean

Makes a deep copy of an object

Kind: static method of Object
Returns: boolean - True if both objects are equal. False, otherwise.

Object.hashCode(obj) ⇒ int

Generates a hash code for an Object.

Kind: static method of Object
Returns: int - The hashcode of the Object.

Object.isNullOrUndefined(obj) ⇒ boolean

Determines if an Object is null or undefined.

Kind: static method of Object
Returns: boolean - True if the Object is null or undefined. False otherwise.

Object.merge(params) ⇒ *

Creates an object that includes members from the source objects

Kind: static method of Object
Returns: * - A new object that combines the source objects.

JSON

Kind: global class

• JSON
  • new JSON()
  • .safeStringify(str, replacer, spaces, cycleRepeater) ⇒ String
  • .serializer(replacer, cycleRepeater) ⇒ function

new JSON()

Placeholder for native JSON class. The methods below are extension methods.

JSON.safeStringify(str, replacer, spaces, cycleRepeater) ⇒ String

Safely serialize an object. Circular references will be tagged.

Kind: static method of JSON
Returns: String - The serialized version of the object.

Example

var result = JSON.safeStringify(sobeObj); // Serialize, not 'pretty'.<br/>
var result = JSON.safeStringify(sobeObj, 2); // Serialize, 'prettify' using 2 spaces.<br/>
var result = JSON.safeStringify(sobeObj, myReplacer);<br/>
var result = JSON.safeStringify(sobeObj, myReplacer, spaces);<br/>
var result = JSON.safeStringify(sobeObj, myReplacer, spaces, myCycleReplacer);

JSON.serializer(replacer, cycleRepeater) ⇒ function

Create a replacer function for stringify that will can handle circular references.

Kind: static method of JSON
Returns: function - Returns a serializer function that can be used by stringify.

String

Kind: global class

• String
  • new String()
  • instance
    • .clone() ⇒ String
    • .endsWith(suffix) ⇒ boolean
    • .equals(other) ⇒ boolean
    • .format(params) ⇒ String
    • .hashCode() ⇒ String
    • .isNullOrEmpty() ⇒ boolean
    • .ltrim() ⇒ String
    • .md5() ⇒ String
    • .print(params)
    • .printf(params)
    • .rtrim() ⇒ String
    • .sprintf(params) ⇒ String
    • .startsWith(suffix) ⇒ boolean
    • .toBoolean() ⇒ boolean
    • .toCamelCase() ⇒ String
    • .toTitleCase() ⇒ String
  • static
    • .EMPTY : String
    • .clone(string) ⇒ String
    • .endsWith(string, suffix) ⇒ boolean
    • .equals(string, other) ⇒ boolean
    • .format(format, params) ⇒ String
    • .generatePassword(length, inclNumbers, inclSymbols) ⇒ string
    • .hashCode(str) ⇒ String
    • .ltrim(str) ⇒ String
    • .isNullOrEmpty(string) ⇒ boolean
    • .md5(str) ⇒ String
    • .print(format, params)
    • .printf(format, params)
    • .rtrim(str) ⇒ String
    • .sprintf(format, params) ⇒ String
    • .startsWith(string, suffix) ⇒ boolean
    • .toBoolean(string) ⇒ boolean
    • .toCamelCase(str) ⇒ String
    • .toTitleCase(str) ⇒ String

new String()

Placeholder for the native String class. The methods below are extension methods.

string.clone() ⇒ String

Returns a new string containing a copy of the current string.

Kind: instance method of String
Returns: String - A copy of the current string.
Example

var newString = 'Hello World'.clone();

string.endsWith(suffix) ⇒ boolean

Determines if the string instance ends with another string.

Kind: instance method of String
Returns: boolean - True if string instance ends with the suffix string. False otherwise.

Example

var endsWith = 'string'.endsWith('ng');

string.equals(other) ⇒ boolean

Compares the current string to another string.

Kind: instance method of String
Returns: boolean - True if the current and other strings are equal. False otherwise.

Example

var isEqual = 'string'.equals('string');

string.format(params) ⇒ String

Formats a string using the current string as the format string. Numbered tokens are used to insert values e.g. 'Format string {0}, {1}, {2}'. The format string is composed of zero or more directives: ordinary characters (excluding %) that are copied directly to the result, and conversion specifications, each of which results in fetching its own parameter.

Kind: instance method of String
Returns: String - The formatted string.

Example

'Hello, my name is {0} {1}.'.format('John', 'Doe');

string.hashCode() ⇒ String

Generates a hashcode for the current string.

Kind: instance method of String
Returns: String - The hashcode for the current string.
Example

'Hello World'.hashCode();

string.isNullOrEmpty() ⇒ boolean

Determine if the current string instance is null, undefined, or zero length.

Kind: instance method of String
Returns: boolean - True if null, undefined, or zero length. False otherwise.

string.ltrim() ⇒ String

Creates a copy of the current string with the leading whitespace removed.

Kind: instance method of String
Returns: String - The current string with the leading spaces removed.
Example

'   Hello World'.ltrim();

string.md5() ⇒ String

Generates a MD5 message digest for the current string instance.

Kind: instance method of String
Returns: String - The MD5 message digest for the current string instance.
Example

'password'.md5();

string.print(params)

Prints a formatted string using the current string as the format string.

Kind: instance method of String
See: String.format

Example

'Hello, my name is {0} {1}.'.print('John', 'Doe');

string.printf(params)

Prints a formatted string using the current string as the format string.

Kind: instance method of String
See: String.sprintf

Example

'Hello, my name is %s %s, I am %d years old.'.printf('John', 'Doe', 46);

string.rtrim() ⇒ String

Creates a copy of the current string with the trailing whitespace removed.

Kind: instance method of String
Returns: String - The current string with the trailing spaces removed.
Example

'Hello World   '.rtrim();

string.sprintf(params) ⇒ String

Formats a string using the current string as the format string. The format string uses tokens e.g. 'Format string %s, %d, %f'

Kind: instance method of String
Returns: String - The formatted string.
See: String.sprintf

Example

'Hello, my name is %s %s, I am %d years old.'.sprintf('John', 'Doe', 46);

string.startsWith(suffix) ⇒ boolean

Determines if the string instance starts with another string.

Kind: instance method of String
Returns: boolean - True if string instance starts with the preffix string. False otherwise.

Example

var startsWith = String.startsWith('string', 'st');

string.toBoolean() ⇒ boolean

Converts the current string instance to a boolean.

Kind: instance method of String
Returns: boolean - True if the string is 'true' or 'yes'. False otherwise.
Example

var isTrue = 'true'.toBoolean();

string.toCamelCase() ⇒ String

Creates a copy of the current string converted to camel case based on word breaks. The words may be separated with dash, underscore, period, or space.

Kind: instance method of String
Returns: String - The current string converted to camel case.
Example

'hello_world'.toCamelCase();

string.toTitleCase() ⇒ String

Creates a copy of the current string converted to title case.

Kind: instance method of String
Returns: String - The current string converted to title case.
Example

'hello world'.toTitleCase();

String.EMPTY : String

An empty string.

Kind: static constant of String

String.clone(string) ⇒ String

Makes a deep copy of a string.

Kind: static method of String
Returns: String - The cloned string.

Example

var string2 = String.clone('copy this string');

String.endsWith(string, suffix) ⇒ boolean

Determines if a string ends with another string.

Kind: static method of String
Returns: boolean - True if string ends with the suffix string. False otherwise.

Example

var endsWith = String.endsWith('string', 'ng');

String.equals(string, other) ⇒ boolean

Compares two strings for equality.

Kind: static method of String
Returns: boolean - True if strings are equal. False otherwise.

Example

var isEqual = String.equals('string', 'string');

String.format(format, params) ⇒ String

Formats a string using numbered tokens e.g. 'Format string {0}, {1}, {2}'.

Kind: static method of String
Returns: String - The formatted string.

Example

String.format('Hello, my name is {0} {1}.', 'John', 'Doe');

String.generatePassword(length, inclNumbers, inclSymbols) ⇒ string

Generate a password.

Kind: static method of String
Returns: string - A new randomly generated password.

String.hashCode(str) ⇒ String

Generates a hashcode for the current string.

Kind: static method of String
Returns: String - The hashcode for the current string.

Example

'Hello World'.hashCode();

String.ltrim(str) ⇒ String

Creates a copy of the current string with the leading whitespace removed.

Kind: static method of String
Returns: String - The current string with the leading spaces removed.

Example

'   Hello World'.ltrim();

String.isNullOrEmpty(string) ⇒ boolean

Determine if a string is null, undefined, or zero length.

Kind: static method of String
Returns: boolean - True if null, undefined, or zero length. False otherwise.

String.md5(str) ⇒ String

Generates a MD5 message digest for the current string instance.

Kind: static method of String
Returns: String - The MD5 message digest for the current string instance.

Example

'password'.md5();

String.print(format, params)

Prints a formatted string.

Kind: static method of String
See: String.format

Example

String.print('Hello, my name is {0} {1}.', 'John', 'Doe');

String.printf(format, params)

Prints a formatted string.

Kind: static method of String
See: String.sprintf

Example

String.printf('Hello, my name is %s %s, I am %d years old.', 'John', 'Doe', 46);

String.rtrim(str) ⇒ String

Creates a copy of the current string with the trailing whitespace removed.

Kind: static method of String
Returns: String - The current string with the trailing spaces removed.

Example

'Hello World   '.rtrim();

String.sprintf(format, params) ⇒ String

Formats a string using tokens e.g. 'Format string %s, %d, %f'.

Kind: static method of String
Returns: String - The formatted string.

String.startsWith(string, suffix) ⇒ boolean

Determines if the string starts with another string.

Kind: static method of String
Returns: boolean - True if string starts with the preffix string. False otherwise.

Example

var startsWith = 'string'.startsWith(, 'st');

String.toBoolean(string) ⇒ boolean

Converts a string to a boolean.

Kind: static method of String
Returns: boolean - True if the string is 'true' or 'yes'. False otherwise.

Example

var isTrue = String.toBoolean('true');

String.toCamelCase(str) ⇒ String

Creates a copy of the current string converted to camel case based on word breaks. The words may be separated with dash, underscore, period, or space.

Kind: static method of String
Returns: String - The current string converted to camel case.

Example

'hello_world'.toCamelCase();

String.toTitleCase(str) ⇒ String

Creates a copy of the current string converted to title case.

Kind: static method of String
Returns: String - The current string converted to title case.

Example

'hello world'.toTitleCase();