Go

Ada has a Go client available on GitHub.

Requirements

Go 1.24 or better.

Installation

go get github.com/ada-url/goada

Usage

import (
    "github.com/ada-url/goada"
    "fmt"
)

url, err := goada.New("https://www.GOogle.com")
if err != nil {
    // handle error
}
fmt.Println(url.Href())     // https://www.google.com/
url.SetProtocol("http:")
url.SetHash("goada")
fmt.Println(url.Hash())     // #goada
fmt.Println(url.Href())     // http://www.google.com/#goada

Why not net/url?

Go’s built-in net/url follows RFC 3986 rather than the WHATWG URL standard used by browsers. This leads to differences in practice:

String source	Value
Input	https://www.7-Eleven.com/Home/../Privacy/Montréal
Ada (goada)	https://www.xn--7eleven-506c.com/Home/Privacy/Montr%C3%A9al
Go net/url	https://www.7-Eleven.com/Home/../Privacy/Montr%C3%A9al

Specifically, Go’s net/url:

• Does not normalize hostnames (no IDNA/Punycode encoding)
• Does not process path components (no dot-segment removal)
• Does not encode special characters in query parameters the same way browsers do

Performance

Benchmarks against the top 100k URLs dataset:

Library	ns/op per URL	WHATWG compliant
github.com/ada-url/goada	22.0	Yes
Go net/url	19.4	No
github.com/nlnwa/whatwg-url	139.0	Yes

goada is the fastest WHATWG-compliant URL parser available for Go.

Run go test -bench BenchmarkTop100 -run - to reproduce these results.

Resources

• Source code
• GoDoc
• Benchmark datasets