# Cloudflare Error Page Generator (Node.js/TypeScript) Carbon copy of the original Python version. ## Installation ```bash npm install cloudflare-error-page ``` Or install from GitHub: ```bash npm install git+https://github.com/donlon/cloudflare-error-page.git#main:nodejs ``` ## Quick Start ```typescript import { render } from 'cloudflare-error-page'; import * as fs from 'fs'; const errorPage = render({ browser_status: { status: 'ok' }, cloudflare_status: { status: 'error', status_text: 'Error' }, host_status: { status: 'ok', location: 'example.com' }, error_source: 'cloudflare', what_happened: '

There is an internal server error on Cloudflare\'s network.

', what_can_i_do: '

Please try again in a few minutes.

', }); fs.writeFileSync('error.html', errorPage); ``` ## API Reference ### `render(params: ErrorPageParams, allowHtml?: boolean): string` Generates an HTML error page based on the provided parameters. #### Parameters - `params`: An object containing error page configuration - `allowHtml` (optional): Whether to allow HTML in `what_happened` and `what_can_i_do` fields. Default: `true` #### ErrorPageParams Interface ```typescript interface ErrorPageParams { // Basic information error_code?: number; // Default: 500 title?: string; // Default: 'Internal server error' html_title?: string; // Default: '{error_code}: {title}' time?: string; // Auto-generated if not provided ray_id?: string; // Auto-generated if not provided client_ip?: string; // Default: '1.1.1.1' // Status for each component browser_status?: StatusItem; cloudflare_status?: StatusItem; host_status?: StatusItem; // Error source indicator error_source?: 'browser' | 'cloudflare' | 'host'; // Content sections what_happened?: string; // HTML content what_can_i_do?: string; // HTML content // Optional customization more_information?: MoreInformation; perf_sec_by?: PerfSecBy; creator_info?: CreatorInfo; } interface StatusItem { status?: 'ok' | 'error'; status_text?: string; // Default: 'Working' or 'Error' status_text_color?: string; // CSS color location?: string; name?: string; } ``` ## Examples ### Basic Error Page ```typescript import { render } from 'cloudflare-error-page'; const html = render({ cloudflare_status: { status: 'error' }, error_source: 'cloudflare', what_happened: '

Something went wrong.

', what_can_i_do: '

Try again later.

', }); ``` ### Express.js Integration ```typescript import express from 'express'; import { render } from 'cloudflare-error-page'; const app = express(); app.use((err, req, res, next) => { const errorPage = render({ error_code: err.status || 500, title: err.message || 'Internal server error', cloudflare_status: { status: 'ok' }, host_status: { status: 'error', location: req.hostname }, error_source: 'host', what_happened: `

${err.message}

`, what_can_i_do: '

Please try again or contact support.

', }); res.status(err.status || 500).send(errorPage); }); ``` ## TypeScript Support This package includes full TypeScript type definitions. Import types as needed: ```typescript import { render, ErrorPageParams, StatusItem } from 'cloudflare-error-page'; ``` ## License MIT ## Related - [Python version](https://github.com/donlon/cloudflare-error-page) - [Online Editor](https://virt.moe/cloudflare-error-page/editor/)

c	File Name	Size	T	Date
zip	examples/	4096	---	2025-12-12 03:19:44
zip	src/	4096	---	2025-12-12 03:19:44
zip	templates/	4096	---	2025-12-12 03:19:44
-	LICENSE	1079	%	2025-12-12 03:19:44
-	README.md	3591	md	2025-12-12 03:19:44
-	package-lock.json	4866	json	2025-12-12 03:19:44
-	package.json	894	json	2025-12-12 03:19:44
-	tsconfig.json	487	json	2025-12-12 03:19:44

🌲 / misc github-archivez cloudflare-error-page nodejs

control-panel