convert-svg-core
Advanced tools
Supports converting SVG into another format using headless Chromium
The core Node.js package for converting SVG into other formats using headless Chromium that contains the shared logic for all converters to support programmatic use. This package is not intended to be used directly to convert SVGs and, instead, provides core support for SVG conversion.
If you are looking to install an out-of-the-box SVG converter, check out our converter packages below:
https://github.com/neocotic/convert-svg
Alternatively, if you know what you're doing, you can install using npm:
npm install --save convert-svg-core
You'll need to have at least Node.js v22 or newer.
If you're looking to create a converter for a new format, we'd urge you to consider contributing to this framework so that it can be easily integrated and maintained. Read the Contributors section for information on how you can contribute.
To create a new SVG converter that uses convert-svg-core, you'll need to create a new subdirectory for your package
under the packages directory. Try to follow the
convert-svg-to-<FORMAT> naming convention for the converter package name.
Take a look at the other packages in this directory to set up the new package directory. They are all very similar, by design, as you should just need to provide the minimal amount of information required to support your intended output format.
Since this package only uses puppeteer-core, a Chromium instance must be provided and connected by the end user (e.g.
using puppeteer to get an executable path).
Testing your SVG converter actually works is just as important as implementing it. Since convert-svg-core contains a
lot of the conversion logic, a
convert-svg-core-test package is
available to make testing implementations even easier. Again, take a look at the tests for existing SVG converters under
the packages directory for examples.
This package supports the use of a CONVERT_SVG_LAUNCH_OPTIONS environment variable to act as a base for the launch
option passed to the Converter constructor. This can make it easier to control the browser launch/connection. For
example;
export CONVERT_SVG_LAUNCH_OPTIONS='{"browser": "firefox", "executablePath": "/Applications/Firefox.app/Contents/MacOS/firefox"}'
If you have any problems with this package or would like to see changes currently in development, you can do so here.
If you want to contribute, you're a legend! Information on how you can do so can be found in CONTRIBUTING.md. We want your suggestions and pull requests!
A list of all contributors can be found in AUTHORS.md.
Copyright © 2025 neocotic
See LICENSE.md for more information on our MIT license.
Version 0.7.1, 2025.06.17
import('puppeteer').executablePath to be passed directly in launch options to allow other launch options to
be passed to it as a functionCONVERT_SVG_* environment variablesFAQs
Supports converting SVG into another format using headless Chromium
The npm package convert-svg-core receives a total of 7,368 weekly downloads. As such, convert-svg-core popularity was classified as popular.
We found that convert-svg-core demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Undocumented protestware found in 28 npm packages disrupts UI for Russian-language users visiting Russian and Belarusian domains.
Research
/Security News
North Korean threat actors deploy 67 malicious npm packages using the newly discovered XORIndex malware loader.
Security News
Meet Socket at Black Hat & DEF CON 2025 for 1:1s, insider security talks at Allegiant Stadium, and a private dinner with top minds in software supply chain security.