ttfb
ttfb copied to clipboard
phip1611
Library + CLI-Tool to measure the TTFB (time to first byte) of HTTP requests. Additionally, this crate measures the times of DNS lookup, TCP connect and TLS handshake.
TTFB: CLI + Lib to Measure the TTFB of HTTP/1.1 Requests
Similar to the network tab in Google Chrome or Mozilla Firefox, this crate helps you find the timings for:
- DNS lookup (if domain is specified, i.e., no IP is given)
- TCP connection start
- TLS handshake (if https/TLS is used)
- Initial GET-Request
- TTFB (Time To First Byte)
It builds upon the crates trust-dns-resolver for modern and secure DNS resolving of domains and native-tls for handling TLS v1.2/1.3.
Cross Platform
CLI + lib work on Linux, MacOS, and Windows.
Usage Binary/CLI tool
Install with cargo install ttfb --features bin. It takes one argument and passes it to the library.
The string you pass here as first argument is the same as for the library function.
Additionally, the CLI takes a -k/--insecure option.
Example: $ ttfb -k https://expired.badssl.com
Usage Library
The library exposes the function ttfb(url: String). The string can be for example:
phip1611.de(defaults tohttp://)http://phip1611.dehttps://phip1611.dehttps://phip1611.de?foo=barhttps://sub.domain.phip1611.de?foo=barhttp://12.34.56.78/foobarhttps://1.1.1.112.34.56.78/foobar(defaults tohttp://)12.34.56.78(defaults tohttp://)
Example Output
If you installed the CLI and invoke it like $ ttfb https://phip1611.de, the output will look like:
TTFB for https://phip1611.de (by [email protected])
PROPERTY REL TIME (ms) ABS TIME (ms)
DNS Lookup : 0.755 0.755 (probably cached)
TCP connect : 35.484 36.239
TLS Handshake : 36.363 72.603
HTTP GET Req : 0.011 72.614
HTTP Resp TTFB: 76.432 149.046
MSRV
The MSRV of the library is 1.65.0 stable.
The MSRV of the binary is 1.70.0 stable.
phip1611