thedaviddias/Front-End-Checklist / skills/error-images
error-images
VerifiedUse when reviewing image assets, markup, and CDN or build transforms related to Handle image loading errors gracefully. Check encoded size, rendered size, loading strategy, and above-the-fold impact together.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.5 KB |
| references/rule.md | markdown | 4.3 KB |
references/rule.md
View on GitHub# Handle image loading errors gracefully
> Broken images are handled gracefully with fallback images or placeholder content.
**Priority:** low · **Difficulty:** beginner · **Time:** 15 min
---
Broken images should fail gracefully with fallback content instead of showing broken icons.
## Code Example
```html
<!-- ❌ Bad: No fallback for broken image -->
<img src="product.jpg" alt="Product">
<!-- ✅ Good: Fallback image on error -->
<img
src="product.jpg"
alt="Product"
onerror="this.src='/images/placeholder.png'; this.onerror=null;"
>
```
## Why It Matters
Broken image icons look unprofessional and confuse users—graceful fallbacks maintain visual consistency and user trust when images fail to load.
## React Error Handling Component
```tsx
interface ImageWithFallbackProps {
src: string
fallback: string
alt: string
className?: string
}
function ImageWithFallback({
src,
fallback,
alt,
className
}: ImageWithFallbackProps) {
const [imgSrc, setImgSrc] = useState(src)
const [hasError, setHasError] = useState(false)
const handleError = () => {
if (!hasError) {
setImgSrc(fallback)
setHasError(true)
}
}
return (
<img
src={imgSrc}
alt={alt}
onError={handleError}
className={className}
/>
)
}
// Usage
```
## Advanced Image Component with States
```tsx
type ImageState = 'loading' | 'loaded' | 'error'
interface SmartImageProps {
src: string
alt: string
fallback?: string
placeholder?: React.ReactNode
className?: string
}
function SmartImage({
src,
alt,
fallback = '/images/placeholder.png',
placeholder,
className
}: SmartImageProps) {
const [state, setState] = useStateImage unavailable</span>
</div>
)
}
return (
<div className={`image-wrapper ${className}`}>
{state === 'loading' && (placeholder || <div className="skeleton" />)}
<img
src={currentSrc}
alt={alt}
onLoad={handleLoad}
onError={handleError}
style={{ opacity: state === 'loaded' ? 1 : 0 }}
/>
</div>
)
}
```
## Next.js Image Error Handling
```tsx
function ProductImage({ src, alt }: { src: string; alt: string }) {
const [imgSrc, setImgSrc] = useState(src)
return (
setImgSrc('/images/product-fallback.png')}
/>
)
}
```
## CSS Fallback for Background Images
```css
/* Fallback background if image fails */
.hero {
background-color: #f0f0f0; /* Fallback color */
background-image: url('hero.jpg');
background-size: cover;
}
/* Styled broken image fallback */
img {
min-height: 100px;
background-color: #f5f5f5;
}
img::before {
content: '';
display: block;
}
img::after {
content: attr(alt);
display: block;
font-size: 14px;
color: #666;
text-align: center;
padding: 20px;
}
```
## Avatar with Initials Fallback
```tsx
interface AvatarProps {
src?: string
name: string
size?: number
}
function Avatar({ src, name, size = 48 }: AvatarProps) {
const [showFallback, setShowFallback] = useState(!src)
const initials = name
.split(' ')
.map(part => part[0])
.join('')
.toUpperCase()
.slice(0, 2)
if (showFallback) {
return (
<div
className="avatar-fallback"
style={{ width: size, height: size }}
aria-label={name}
>
{initials}
</div>
)
}
return (
<img
src={src}
alt={name}
width={size}
height={size}
className="avatar"
onError={() => setShowFallback(true)}
/>
)
}
```
## Error Logging
```typescript
function logImageError(src: string, error: Event) {
// Log to monitoring service
console.error('Image failed to load:', src)
// Send to analytics
if (window.analytics) {
window.analytics.track('Image Load Error', {
src,
page: window.location.pathname
})
}
}
// Usage in component
<img
src={src}
alt={alt}
onError={(e) => {
logImageError(src, e)
handleFallback()
}}
/>
```
## Verification
1. Block images in DevTools (Network tab → Block request URL)
2. Test with invalid image URLs
3. Verify fallback appears correctly
4. Check that alt text is accessible when fallback shows
5. Test slow network—loading states should appear
Always check if fallback has already been applied before setting it. Without this check, a broken fallback image causes an infinite loop of error events.Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |