string-similarity-score

Finds degree of similarity (Percentage or score) between two strings, based on Dice's Coefficient, which is mostly better than Levenshtein distance.

Table of Contents

• string-similarity
  • Table of Contents
  • Usage
    • For Node.js
  • API
    • compareTwoStrings(string1, string2)
      • Arguments
      • Returns
      • Examples
    • findBestMatch(mainString, targetStrings)
      • Arguments
      • Returns
      • Examples

Usage

For Node.js

Install using:

1npm install string-similarity-score --save

In your code:

1var stringSimilarity = require("string-similarity-score");
2
3var similarity = stringSimilarity.compareTwoStrings("healed", "sealed");
4
5var matches = stringSimilarity.findBestMatch("healed", [
6  "edward",
7  "sealed",
8  "theatre",
9]);

API

The package contains two methods:

compareTwoStrings(string1, string2)

Returns a fraction between 0 and 1, which indicates the degree of similarity between the two strings. 0 indicates completely different strings, 100 indicates identical strings. The comparison is case-sensitive.

Arguments

1. string1 (string): The first string
2. string2 (string): The second string

Order does not make a difference.

Returns

(number): A Percentage from 0 to 100, both inclusive. Higher number indicates more similarity.

Examples

1stringSimilarity.compareTwoStrings("healed", "sealed");
2// → 80
3
4stringSimilarity.compareTwoStrings(
5  "Olive-green table for sale, in extremely good condition.",
6  "For sale: table in very good  condition, olive green in colour."
7);
8// → 60
9
10stringSimilarity.compareTwoStrings(
11  "Olive-green table for sale, in extremely good condition.",
12  "For sale: green Subaru Impreza, 210,000 miles"
13);
14// → 25
15
16stringSimilarity.compareTwoStrings(
17  "Olive-green table for sale, in extremely good condition.",
18  "Wanted: mountain bike with at least 21 gears."
19);
20// → 14

findBestMatch(mainString, targetStrings)

Compares mainString against each string in targetStrings.

Arguments

1. mainString (string): The string to match each target string against.
2. targetStrings (Array): Each string in this array will be matched against the main string.

Returns

(Object): An object with a ratings property, which gives a similarity rating for each target string, a bestMatch property, which specifies which target string was most similar to the main string, and a bestMatchIndex property, which specifies the index of the bestMatch in the targetStrings array.

Examples

1stringSimilarity.findBestMatch('Olive-green table for sale, in extremely good condition.', [
2  'For sale: green Subaru Impreza, 210,000 miles',
3  'For sale: table in very good condition, olive green in colour.',
4  'Wanted: mountain bike with at least 21 gears.'
5]);
6// →
7{ ratings:
8   [ { target: 'For sale: green Subaru Impreza, 210,000 miles',
9       rating: 25 },
10     { target: 'For sale: table in very good condition, olive green in colour.',
11       rating: 60 },
12     { target: 'Wanted: mountain bike with at least 21 gears.',
13       rating: 14 } ],
14  bestMatch:
15   { target: 'For sale: table in very good condition, olive green in colour.',
16     rating: 60 },
17  bestMatchIndex: 1
18}