Snapshot errors
Snapshot errors arise when Warhol has problems understanding the pattern library. They must not be confused with report types, which are the building blocks of Warhol's test results. You only have to care about snapshot issues if Warhol fails to process something in your pattern library. The most common causes of show-stopping snapshot errors are problems in the pattern library's configuration, but Warhol may also complain about its own inability to understand some arcane CSS features.
There are three error types that help you to classify the severity of whatever Warhol reports:
ERROR
(red): an isolated problem prevented Warhol from analyzing parts of the pattern libraryFATAL
(black): something went catastrophically wrong and Warhol had to abort analyzing the pattern libraryDEBUG
(purple): diagnostic messages that Warhol thinks may help with debugging other issues (or Warhol itself)
FATAL
errors prevent Warhol from doing anything useful with the pattern
library, while everything of type ERROR
only affects Warhol's understanding of
some of the patterns (e.g. only a single component or just the theme colors).
Table of Contents
- Ambiguous component example • An element matches more than one component source selector
- Color element not found • Color source element not found in the pattern library
- Color property not declared • A color property that was configured as a source is not declared
- Component not found • A component selector matches no element
- Conflicting utilities • A number of utilities cannot be combined
- Empty utility rule • A style utility rule contains no declarations
- Feature not supported • A Warhol feature is currently not supported
- Hyperactive DOM • The pattern library's DOM did not stop updating after loading
- Icon source not found • Icon source element not found in the pattern library
- Inaccessible style sheet • Warhol was unable to process style sheets in the pattern library
- Inconsistent component styles • Component element styles are not consisitent
- Inconsistent utility • Utility element styles are not consistent
- Invalid color property • A non-color property was defined as a theme color property
- Invalid color source selector • The selector for color sources is not a valid CSS selector
- Invalid component selector • The selector for a component source is not a valid CSS selector
- Invalid icon source selector • The selector for an icon source is not a valid CSS selector
- Invalid layout mode • An invalid value was used in a layout-mode directive
- Invalid must-match selector • A selector in a must-(not)-match directive is not a valid CSS selector
- Invalid options • Invalid options were passed to the snapshot function
- Invalid typography source selector • The selector for a typography source is not a valid CSS selector
- Invisible Typography • Typography examples contain no visible text
- No colors found • Failed to read colors from the pattern library
- Non-unique component selector • Warhol is not quite sure about a component match in the pattern library
- No typography found • Failed to read typography data from the pattern library
- Typography not explicitly declared • Typography styles are inherited
- Unstyled utility example • A utility element has no styles
- Redundant utilities • Several utilities define the same styles
- Unsupported rule • Warhol does not understand on or more CSS rules on the page
- Utility not found • A utility source element was not found