Adds streaming HTMLRewriter content docs and changelog

Author: mikenomitch

src/content/changelogs-next/2025-02-03-html-rewriter-streaming.mdx

@@ -0,0 +1,40 @@
+---
+title: Rewrite HTML with streaming content
+description: HTMLRewiter now supports streamed content for more efficient replacement of HTML elements
+products:
+  - workers
+date: 2025-02-03T3:00:00Z
+---
+
+import { Render, TypeScriptExample } from "~/components";
+
+[`HTMLRewriter`](/workers/runtime-apis/html-rewriter) now supports replacing HTML with content from a stream.
+
+This allows you to process HTML more efficiently, as content does not have to be loaded into memory before replacements are made.
+
+[`Response`](/workers/runtime-apis/response/) and [`ReadableStream`](/workers/runtime-apis/streams/readablestream/) values can now
+be passed as [`Content`](/workers/runtime-apis/html-rewriter/#global-types) into methods duch as
+`replace`, `append`, and `prepend`.
+
+<TypeScriptExample filename="index.ts">
+```ts
+class ElementRewriter {
+	async element(element: any) {
+		// able to replace elements while streaming content
+		// the fetched body is not buffered into memory as part
+		// of the replace
+		let res = await fetch('https://upstream-content-provider.example');
+		element.replace(res);
+	}
+}
+
+export default {
+	async fetch(request, env, ctx): Promise<Response> {
+		let response = await fetch('https://site-to-replace.com');
+		return new HTMLRewriter().on('[data-to-replace]', new ElementRewriter()).transform(response);
+	},
+} satisfies ExportedHandler<Env>;
+```
+</TypeScriptExample>
+
+For more information, see the [`HTMLRewriter` documentation](/workers/runtime-apis/html-rewriter).

src/content/docs/workers/runtime-apis/html-rewriter.mdx

@@ -30,9 +30,9 @@ Throughout the `HTMLRewriter` API, there are a few consistent types that many pr
 
 
 
-* `Content` string
+* `Content` string, Response, or ReadableStream
 
-  * Content inserted in the output stream should be a string.
+  * Content inserted in the output stream should be a string, a [`Response`](/workers/runtime-apis/response/), or a [`ReadableStream`](/workers/runtime-apis/streams/readablestream/).
 
 * `ContentOptions` Object