Usage

To clean up and validate icon, run cleanupSVG().

Function has only one parameter:

• svg, SVG. Icon instance.

Function does not return anything, it applies changes to SVG instance.

Clean up function is asynchronous. That means you need to handle it as Promise instance, usually by adding await before function call.

On error function will throw an exception.

Clean up process

Clean up process runs several functions that do various tasks:

• cleanupInlineStyle() checks inline styles and removes unneeded styles.
• convertStyleToAttrs() converts style to attributes.
• cleanupSVGRoot() cleans up <svg> element.
• checkBadTags() checks icon for bad tags.
• removeBadAttributes() removes bad attributes.

If you want to, you can run functions listed above, in order listed above. It will be identical to running cleanupSVG(). All functions are asynchronous.

Optimisation

Clean up functions do not optimise icon data, they do not rewrite any shapes. Functions only remove most dead code, making it easier to process icon.

Optimisation should be done separately. See icon manipulation functions.

Opinionated validation

Validation is opinionated. It is intended to be used to produce icons that are available to anyone, therefore it is rather strict.

Icon validation fails if icon:

• Contains any scripts. Untrusted scripts are dangerous.
• Contains any text. This is heavily opinionated. Reasoning is usually icons that use text are exported by designers not realising that they are using fonts that are not installed on every computer, therefore icon will look different than intended. Convert text to shapes before exporting it from your editor.
• Contains any raster images. Raster images in vector shapes are uncceptable because they do not scale. Icons are meant to scale without limitations.

Example