Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including parse-database-url with all npm packages installed. Try it out:

var parseDatabaseUrl = require("parse-database-url")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

parse-database-url v0.3.0

Database configuration URL parser for node.js

DATABASE_URL parser for node.js

Build Status NPM Version

This is an npm package that parses database configurations passed in as URLs. This is typically useful in Heroku deployments, where the database configuration is given in the DATABASE_URL environment variable.

Supported Platforms

This library is tested against the following platforms.

Keep in mind that the versions above are not hard requirements.

Installation and Usage

The preferred installation method is to add the library to the dependencies section in your package.json.

  "dependencies": {
    "parse-database-url": "*"

Alternatively, npm can be used to install the library directly.

npm install parse-database-url

Once the library is installed, require-ing it returns the function that parses URLs.

var parseDbUrl = require("parse-database-url");

And you can use that to parse URLs :)

var dbConfig = parseDbUrl(process.env["DATABASE_URL"]);


The library comes with unit tests. Please make sure they pass before submitting a pull request.

npm install
npm test

If you modify the parser, please add test cases showing your changes to test/parse_cases.json.

Copyright and License

The library is Copyright (c) 2013 Victor Costan, and distributed under the MIT License.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free