Popularity
1.3
-
Activity
9.2
Declining
143
2
1

Description

Super fast specification compliant URL parser state machine for Node.js.

Programming language: JavaScript
License: MIT License
Tags: Editors     URL     JavaScript     Js    

URL Parser alternatives and similar libraries

Based on the "Editors" category.
Alternatively, view url-js alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of URL Parser or a related project?

Add another 'Editors' Library
Less time debugging, more time building
sponsored scoutapm.com

Popular Comparisons

Deliver Cleaner and Safer Code - Right in Your IDE of Choice!
sponsored www.sonarlint.org

README

URL Parser

This repository contains a work in progress state machine 100% compliant to the URL parser specification. The goal is to create a performant URL parser.

For more information about the URL parsing state machine visit here.

Installation

npm i --save url-state-machine

Usage

const URLStateMachine = require('url-state-machine')
const state = new URLStateMachine('https://www.yagiz.co/implementing-node-js-url-parser-in-webassembly-with-rust/')

console.log(state.url)

Benchmarks

Here's the current benchmarks comparing url-state-machine with the native URL implementation and whatwg-url.

Even though these benchmarks provide a good reference for url-state-machine, should not be taken in any consideration since the implementation of url-state-machine is not finished, and does not reflect the final performance of it.

╔═══════════════════╤═════════╤══════════════════╤═══════════╗
║ Slower tests      │ Samples │           Result │ Tolerance ║
╟───────────────────┼─────────┼──────────────────┼───────────╢
║ whatwg-url        │    1500 │  52643.30 op/sec │  ± 0.85 % ║
║ url-state-machine │    1500 │  60174.30 op/sec │  ± 0.97 % ║
╟───────────────────┼─────────┼──────────────────┼───────────╢
║ Fastest test      │ Samples │           Result │ Tolerance ║
╟───────────────────┼─────────┼──────────────────┼───────────╢
║ URL               │   10000 │ 914694.49 op/sec │  ± 2.42 % ║
╚═══════════════════╧═════════╧══════════════════╧═══════════╝

Testing

All tests are referenced and borrowed from web-platform-tests.

Test Files  1 failed (1)
     Tests  189 failed | 544 passed (733)
      Time  76ms

Conformance to specification

We're currently testing only the following attributes for URL

  • pathname
    • 93 failed | 640 passed (733)
  • host
    • 72 failed | 661 passed (733)
  • password
    • 2 failed | 731 passed (733)
  • protocol
    • 1 failed | 732 passed (733)
  • username
    • 733 passed (733)
  • port
    • 733 passed (733)
  • fragment
    • 733 passed (733)
  • query
    • 733 passed (733)