{"id":15647903,"url":"https://github.com/ulisesgascon/check-my-headers","last_synced_at":"2025-04-16T05:57:05.096Z","repository":{"id":42470051,"uuid":"239619939","full_name":"UlisesGascon/check-my-headers","owner":"UlisesGascon","description":"Fast and simple way to check any HTTP Headers","archived":false,"fork":false,"pushed_at":"2023-06-25T11:02:12.000Z","size":916,"stargazers_count":45,"open_issues_count":8,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-11T03:01:50.583Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UlisesGascon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-02-10T21:45:22.000Z","updated_at":"2024-07-09T07:49:00.000Z","dependencies_parsed_at":"2024-01-06T22:37:51.061Z","dependency_job_id":"ff40a34d-e566-443c-b899-67863bd33b0e","html_url":"https://github.com/UlisesGascon/check-my-headers","commit_stats":{"total_commits":57,"total_committers":4,"mean_commits":14.25,"dds":"0.22807017543859653","last_synced_commit":"a3731b4c30cd4ceb2df3b3507a32a92a010db044"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UlisesGascon%2Fcheck-my-headers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UlisesGascon%2Fcheck-my-headers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UlisesGascon%2Fcheck-my-headers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UlisesGascon%2Fcheck-my-headers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UlisesGascon","download_url":"https://codeload.github.com/UlisesGascon/check-my-headers/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249205654,"owners_count":21229967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T12:21:54.917Z","updated_at":"2025-04-16T05:57:05.078Z","avatar_url":"https://github.com/UlisesGascon.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003ch1 align=\"center\"\u003e\n  check-my-headers\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Fast and simple way to check any HTTP Headers\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.org/package/check-my-headers\"\u003e\u003cimg src=\"https://badgen.net/npm/v/check-my-headers\" alt=\"npm version\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.org/package/check-my-headers\"\u003e\u003cimg src=\"https://badgen.net/npm/license/check-my-headers\" alt=\"license\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.org/package/check-my-headers\"\u003e\u003cimg src=\"https://badgen.net/npm/dt/check-my-headers\" alt=\"downloads\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://snyk.io/test/github/ulisesgascon/check-my-headers\"\u003e\u003cimg src=\"https://snyk.io/test/github/ulisesgascon/check-my-headers/badge.svg\" alt=\"Known Vulnerabilities\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./.github/screen.png\" alt=\"Screenshot of npm module called is check my headers that in a aast and simple way check any HTTP Headers\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Thanks \u003ca href=\"https://github.com/lirantal\"\u003eLiran Tal\u003c/a\u003e and the amazing \u003ca href=\"https://snyk.io\"\u003eSnyk team\u003c/a\u003e for your support 😊\n\u003c/p\u003e\n\n\u003c/p\u003e\n\n\n# About\n\nFast and simple way to check any HTTP Headers\n\n# Usage\n\n## Command line\n\nUsing Node.js's `npx` to run a one-off scan of a website:\n\n```bash\nnpx check-my-headers https://example.com \n```\n\nThe CLI will gracefully handle cases where the URL to scan is missing or wrong:\n\n```bash\n$ npx check-my-headers\n👋  Welcome to check-my-headers@0.1.0\n😬  Missing argument URL!\n👉  Example: check-my-headers https://github.com/ulisesgascon/check-my-headers\n```\n\n## Module\n\nUsing `check-my-headers` in your project.\n\n```js\nconst checkMyHeaders = require('check-my-headers')\n\ncheckMyHeaders(\"http://example.com\")\n.then(({ messages, headers, status }) =\u003e {\n    console.log(`Status code: ${status}`)\n    console.log(`Messages:`)\n    console.log(messages)\n    console.log(\"Current headers:\")\n    console.log(headers)\n})\n```\n\nOutput:\n```\nStatus code: 200\nMessages:\n[\n  { msg: 'Remove field: server', type: 'error' },\n  { msg: 'Missing field: content-security-policy', type: 'error' },\n  { msg: 'Missing field: referrer-policy', type: 'error' },\n  { msg: 'Missing field: strict-transport-security', type: 'error' },\n  { msg: 'Missing field: x-xss-protection', type: 'error' },\n  { msg: 'Missing field: x-content-type-options', type: 'error' },\n  { msg: 'Missing field: access-control-allow-origin', type: 'warn' },\n  { msg: 'Missing field: access-control-allow-methods', type: 'warn' },\n  { msg: 'Missing field: access-control-allow-headers', type: 'warn' },\n  { msg: 'Missing field: link', type: 'warn' },\n  { msg: 'Deprecated field: expires', type: 'warn' },\n  { msg: 'Extra field: etag', type: 'info' },\n  { msg: 'Extra field: last-modified', type: 'info' },\n  { msg: 'Extra field: vary', type: 'info' },\n  { msg: 'Extra field: x-cache', type: 'info' },\n  { msg: 'Extra field: connection', type: 'info' }\n]\nCurrent headers:\n{\n  age: '534610',\n  'cache-control': 'max-age=604800',\n  'content-type': 'text/html; charset=UTF-8',\n  date: 'Wed, 12 Feb 2020 19:37:45 GMT',\n  etag: '\"3147526947+ident\"',\n  expires: 'Wed, 19 Feb 2020 19:37:45 GMT',\n  'last-modified': 'Thu, 17 Oct 2019 07:18:26 GMT',\n  server: 'ECS (nyb/1D2A)',\n  vary: 'Accept-Encoding',\n  'x-cache': 'HIT',\n  'content-length': '1256',\n  connection: 'close'\n}\n```\n\n## Docker\n\nUse Docker Hub:\n\n```bash\n# Pull the image from Docker Hub:\ndocker pull ulisesgascon/check-my-headers:latest\n\n# Run container:\ndocker run --rm -e SCAN_URL=\"https://www.github.com/\" ulisesgascon/check-my-headers:latest\n```\n\n`SCAN_URL` is an environment variable and its value must be replaced with the desired URL during Docker run. Docker container will exit once the scan has been completed.\n\nTo build and run the container locally:\n\n```bash\n# Clone Repo:\ngit clone https://github.com/ulisesgascon/check-my-headers.git\n\n# Change to repo's cloned directory:\ncd check-my-headers\n\n# Build Image locally:\ndocker build --no-cache -t ulisesgascon/check-my-headers:latest .\n\n# Run container:\ndocker run --rm -e SCAN_URL=\"https://www.github.com/\" ulisesgascon/check-my-headers:latest\n```\n\n\n# Install\n\nYou can install globally via:\n\n```bash\nnpm install -g check-my-headers\n```\n\n\n# Test\n\nYou can run them:\n\n```bash\nnpm run test:coverage\n```\n\n# Contributing\n\nPlease consult [CONTRIBUTING](./CONTRIBUTING.md) for guidelines on contributing to this project.\n\n# Author\n\n**check-my-headers** © [Ulises Gascón](https://github.com/ulisesgascon), Released under the [MIT](./LICENSE) License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulisesgascon%2Fcheck-my-headers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fulisesgascon%2Fcheck-my-headers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulisesgascon%2Fcheck-my-headers/lists"}