URL Inspector

A lightweight and developer-friendly Node.js library for inspecting URLs. Easily retrieve information about redirects, response headers, DNS records, SSL certificates, response times, and more through a simple API.

Github

https://github.com/DefNotArham/url-inspector-arham-npm

Features

• 🔍 Inspect any URL
• 🔀 Track redirect chains
• 📡 Retrieve HTTP response headers
• 🔒 Inspect SSL certificate information
• 🌐 Perform DNS lookups
• ⏱️ Measure response time
• 🛡️ Analyze common security headers
• 📦 Lightweight with minimal dependencies
• 💙 Full TypeScript support

Installation

npm install url-inspector

Usage

import { inspect } from "url-inspector";

const result = await inspect("https://example.com");

console.log(result);

Example output:

{
  "url": "https://example.com",
  "status": 200,
  "responseTime": 74,
  "redirects": [],
  "headers": {
    "content-type": "text/html; charset=UTF-8"
  },
  "ssl": {
    "valid": true,
    "issuer": "Let's Encrypt"
  }
}

API

inspect(url, options?)

Inspects a URL and returns useful information about the request.

Parameters

| Name | Type | Description | | --------- | -------- | ------------------------------- | | url | string | The URL to inspect. | | options | object | Optional configuration options. |

Returns

Returns a Promise containing information about the inspected URL, including:

• HTTP status
• Response time
• Response headers
• Redirect chain
• SSL certificate details
• DNS information (if enabled)

Use Cases

• Validate URLs before storing them
• Check website availability
• Monitor response times
• Analyze redirects
• Inspect SSL certificates
• Debug API endpoints
• Build uptime monitoring tools

Requirements

• Node.js 18 or newer

Contributing

Contributions are welcome!

If you'd like to contribute:

1. Fork the repository.
2. Create a new branch.
3. Make your changes.
4. Commit your changes.
5. Open a pull request.

If you find a bug or have a feature request, feel free to open an issue.

License

This project is licensed under the MIT License.