Exemples de base
Voici quelques exemples d'utilisation de base de Sharp pour vous aider à démarrer rapidement.
Redimensionner une image
Redimensionnement simple
javascript
import sharp from 'sharp';
// Redimensionner aux dimensions spécifiées
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');Conserver le ratio d'aspect
javascript
// Spécifier uniquement la largeur, la hauteur est calculée automatiquement
await sharp('input.jpg')
.resize(300)
.toFile('output.jpg');
// Spécifier uniquement la hauteur, la largeur est calculée automatiquement
await sharp('input.jpg')
.resize(null, 200)
.toFile('output.jpg');Modes d'adaptation
javascript
// cover: Conserver le ratio d'aspect, recadrer les parties dépassantes
await sharp('input.jpg')
.resize(300, 200, { fit: 'cover' })
.toFile('output.jpg');
// contain: Conserver le ratio d'aspect, ajouter un fond
await sharp('input.jpg')
.resize(300, 200, { fit: 'contain', background: { r: 255, g: 255, b: 255 } })
.toFile('output.jpg');Conversion de format
JPEG vers PNG
javascript
await sharp('input.jpg')
.png()
.toFile('output.png');PNG vers JPEG
javascript
await sharp('input.png')
.jpeg({ quality: 80 })
.toFile('output.jpg');Convertir en WebP
javascript
await sharp('input.jpg')
.webp({ quality: 80 })
.toFile('output.webp');Convertir en AVIF
javascript
await sharp('input.jpg')
.avif({ quality: 80 })
.toFile('output.avif');Rotation d'image
Rotation de 90 degrés
javascript
await sharp('input.jpg')
.rotate(90)
.toFile('output.jpg');Rotation automatique (selon EXIF)
javascript
await sharp('input.jpg')
.rotate() // Rotation automatique
.toFile('output.jpg');Retournement d'image
Retournement vertical
javascript
await sharp('input.jpg')
.flip()
.toFile('output.jpg');Retournement horizontal
javascript
await sharp('input.jpg')
.flop()
.toFile('output.jpg');Recadrage d'image
Recadrer une zone spécifiée
javascript
await sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.toFile('output.jpg');Recadrer et redimensionner
javascript
await sharp('input.jpg')
.extract({ left: 100, top: 100, width: 300, height: 200 })
.resize(150, 100)
.toFile('output.jpg');Effets de filtre
Conversion en niveaux de gris
javascript
await sharp('input.jpg')
.grayscale()
.toFile('output.jpg');Effet de flou
javascript
await sharp('input.jpg')
.blur(5)
.toFile('output.jpg');Effet de netteté
javascript
await sharp('input.jpg')
.sharpen()
.toFile('output.jpg');Inversion de couleur
javascript
await sharp('input.jpg')
.negate()
.toFile('output.jpg');Ajustement des couleurs
Ajustement de la luminosité
javascript
await sharp('input.jpg')
.modulate({ brightness: 1.2 })
.toFile('output.jpg');Ajustement de la saturation
javascript
await sharp('input.jpg')
.modulate({ saturation: 0.8 })
.toFile('output.jpg');Ajustement de la teinte
javascript
await sharp('input.jpg')
.modulate({ hue: 180 })
.toFile('output.jpg');Traitement de la transparence
Ajouter la transparence
javascript
await sharp('input.jpg')
.ensureAlpha()
.png()
.toFile('output.png');Supprimer la transparence
javascript
await sharp('input.png')
.flatten({ background: { r: 255, g: 255, b: 255 } })
.jpeg()
.toFile('output.jpg');Paramètres de qualité
Qualité JPEG
javascript
// Haute qualité
await sharp('input.png')
.jpeg({ quality: 95 })
.toFile('output.jpg');
// Qualité moyenne
await sharp('input.png')
.jpeg({ quality: 80 })
.toFile('output.jpg');
// Basse qualité (petit fichier)
await sharp('input.png')
.jpeg({ quality: 50 })
.toFile('output.jpg');Qualité WebP
javascript
await sharp('input.jpg')
.webp({ quality: 80, lossless: false })
.toFile('output.webp');Opérations en chaîne
Combinaison de plusieurs opérations
javascript
await sharp('input.jpg')
.resize(800, 600)
.rotate(90)
.blur(2)
.sharpen()
.jpeg({ quality: 80 })
.toFile('output.jpg');Traitement conditionnel
javascript
const image = sharp('input.jpg').resize(300, 200);
if (needsBlur) {
image.blur(3);
}
if (needsSharpen) {
image.sharpen();
}
await image.jpeg({ quality: 80 }).toFile('output.jpg');Gestion des erreurs
Gestion d'erreurs de base
javascript
try {
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
} catch (error) {
console.error('Échec du traitement d'image:', error.message);
}Vérifier l'existence du fichier
javascript
const fs = require('fs');
if (fs.existsSync('input.jpg')) {
await sharp('input.jpg')
.resize(300, 200)
.toFile('output.jpg');
} else {
console.error('Le fichier d'entrée n'existe pas');
}Traitement en flux
Lire depuis un flux
javascript
const fs = require('fs');
fs.createReadStream('input.jpg')
.pipe(sharp().resize(300, 200))
.pipe(fs.createWriteStream('output.jpg'));Sortie vers un flux
javascript
const fs = require('fs');
sharp('input.jpg')
.resize(300, 200)
.jpeg({ quality: 80 })
.pipe(fs.createWriteStream('output.jpg'));Traitement Buffer
Créer depuis un Buffer
javascript
const fs = require('fs');
const inputBuffer = fs.readFileSync('input.jpg');
const outputBuffer = await sharp(inputBuffer)
.resize(300, 200)
.jpeg({ quality: 80 })
.toBuffer();
fs.writeFileSync('output.jpg', outputBuffer);Sortie vers Buffer
javascript
const buffer = await sharp('input.jpg')
.resize(300, 200)
.jpeg({ quality: 80 })
.toBuffer();
// Peut utiliser directement le buffer
console.log('Taille de l'image:', buffer.length);Traitement par lot
Traiter toutes les images d'un répertoire
javascript
const fs = require('fs').promises;
const path = require('path');
async function processImages(inputDir, outputDir) {
const files = await fs.readdir(inputDir);
for (const file of files) {
if (file.match(/\.(jpg|jpeg|png|webp)$/i)) {
try {
await sharp(path.join(inputDir, file))
.resize(300, 200)
.jpeg({ quality: 80 })
.toFile(path.join(outputDir, file));
console.log(`Traitement terminé: ${file}`);
} catch (error) {
console.error(`Échec du traitement ${file}:`, error.message);
}
}
}
}
processImages('./input', './output');