VerbalExpressions
JavaScript Regular Expressions made easy
VerbalExpressions is a JavaScript library that helps construct difficult regular expressions.
How to get started
In the browser
Or use the jsDelivr CDN.
On the server (node.js)
Install:
npm install verbal-expressions
Require:
const VerEx = ;
Or use ES6's import
:
;
Running tests
npm test
(or)
npm run test:verbose
Creating a minified version
npm run build
This will run Babel on VerbalExpressions.js
and output the result to dist/verbalexpressions.js
. A minified version of the same will also be written to dist/verbalexpressions.min.js
.
A source map will also be created in dist
, so you can use the original "un-babelified", unminified source file for debugging purposes.
API documentation
You can find the API documentation at verbalexpressions.github.io/JSVerbalExpressions. You can find the source code for the docs in docs
.
Examples
Here are some simple examples to give an idea of how VerbalExpressions works:
Testing if we have a valid URL
// Create an example of how to test for correctly formed URLsconst tester = ; // Create an example URLconst testMe = 'https://www.google.com'; // Use RegExp object's native test() functionif tester ; // This output will fire else ; console; // Outputs the actual expression used: /^(http)(s)?(\:\/\/)(www\.)?([^\ ]*)$/
Replacing strings
// Create a test stringconst replaceMe = 'Replace bird with a duck'; // Create an expression that seeks for word "bird"const expression = ; // Execute the expression like a normal RegExp objectconst result = expression; // Outputs "Replace duck with a duck";
Shorthand for string replace
const result = ; // Outputs "We have a blue house";
Contributions
Pull requests are warmly welcome!
Clone the repo and fork:
git clone https://github.com/VerbalExpressions/JSVerbalExpressions.git
Style guide
The Airbnb style guide is loosely used as a basis for creating clean and readable JavaScript code. Check .eslintrc
.
Check out these slide decks for handy Github & git tips:
Tools
- https://verbalregex.com - it's a wrapper of JSVerbalExpressions; users can write down the code and compile to regex
- https://jsbin.com/metukuzowi/edit?js,console - JSBin Playground
Other Implementations
You can see an up to date list of all ports on VerbalExpressions.github.io.
If you would like to contribute another port (which would be awesome!), please open an issue specifying the language in the VerbalExpressions/implementation repo. Please don't open PRs for other languages against this repo.