@halfmatthalfcat/svgdom-cf
v0.2.8
Published
Cloudflare Worker compatible svgdom implementation
Downloads
8
Maintainers
Readme
svgdom-cf
This is a fork of the original svgdotjs/svgdom
that is compatible with running in Cloudflare Workers.
It removes many of the non-supported Node API depdencies and replaces them with CF Worker compabile
alternatives, namely around image sizing and font handling.
Install
npm install @halfmatthalfcat/svgdom-cf
Fonts
To utilize fonts, you must load your own fonts into svgdom
, there are no default fonts. If you do not, any usage of fonts will essentially noop.
Instead of the original way of loading fonts from the file system, this fork of svgdom
acceps font Buffers and uses the postscript name of the supplied font to identify itself.
If you need to get the postscript name to subsequenty use, leverage the getPostscriptName
function that is exported from this package.
Supported Font Types
Font loading is controlled by the fontkit library. It supports:
- TIFF
- WOFF
- WOFF2
- TrueType
- DFont
Wrangler Config
Cloudflare allows you to import and bundle raw data files when deploying Workers. You can do this by
configuring your wrangler.toml
to allow imported file types of certain extensions to be bundled as Buffers via:
rules = [
{ type = "Data", globs = ["**/*.woff2"], fallthrough = true }
]
Usage
In your CF Worker, you will want to import and load the fonts outside of your handler to cache between invocations.
import { setFonts } from "@halfmatthalfcat/svgdom-cf";
import Ariel from "./ariel.woff2";
import TimesNewRoman from "./tnr.tiff";
setFonts(Ariel, TimesNewRoman);
export default {
fetch() {
// CF fetch handler
},
};
You typically don't use svgdom
alone, but with SVG.js
to actually build SVGs. Luckily, there is a
companion library @halfmatthalfcat/svg-cf
that combines this library, a modified SVG.js
and the usage
of AsyncLocalStorage to efficiently build SVGs to serve in Workers.
Check out the @halfmatthalfcat/svg-cf project for more info.