String Similarity

A simple, lightweight (~700 bytes minified) string similarity function based on comparing the number of bigrams in common between any two strings. Returns a score between 0 and 1 indicating the strength of the match.

Based on the Sørensen–Dice coefficient, this algorithm is most effective at detecting rearranged words or misspellings. It tends to be less effective with very short strings, unless perhaps you switch to comparing individual characters in common instead of bigrams.

It is case insensitive unless you specify otherwise. Does not ignore punctuation or spaces. In some cases, removing punctuation beforehand may improve accuracy.

Update

Version 2.0 optimizes the algorithm from O(n²) time complexity to O(n), and switches from using an array for bigrams to a Map, which was found to be substantially faster in performance tests.

Usage

Requirements

This library uses built-in Map data structure for optimal performance. Therefore, it requires at least IE11 or a polyfill for Map.

Examples

1import { stringSimilarity } from "string-similarity-js";
2
3// Rearranged words
4stringSimilarity("Lorem ipsum", "Ipsum lorem")
5// Returns a score of 0.9
6
7// Typos
8stringSimilarity("The quick brown fox jumps over the lazy dog", "The quck brown fx jumps over the lazy dog")
9// 0.92
10
11// Even more different
12stringSimilarity("The quick brown fox jumps over the lazy dog", "The quack brain fax jomps odor the lady frog")
13// 0.65
14
15// Completely different strings
16stringSimilarity("The quick brown fox jumps over the lazy dog", "Lorem ipsum")
17// 0.07
18
19// Tiny strings are less effective with default settings
20stringSimilarity("DMV", "DNV")
21// Returns 0, because technically there are no bigrams in common between the two
22
23// Passing in a substring length of 1 may improve accuracy on tiny strings
24stringSimilarity("DMV", "DNV", 1)
25// Returns 0.67, the percentage of letters in common between the two

License

This project is licensed under the MIT License - see the LICENSE.md file for details