Ce guide explique comment utiliser la bibliothèque cliente JavaScript pour téléverser, lister, télécharger et supprimer des fichiers dans votre bucket App Storage.
Cette bibliothèque cliente, écrite en TypeScript, peut être utilisée pour des projets utilisant des runtimes JavaScript tels que Bun, Deno et Node.js 14 et versions ultérieures.
Créer une application Replit TypeScript
- Sélectionnez
Create App depuis l’écran d’accueil.
- Accédez à l’onglet Choose a Template.
- Tapez « TypeScript » dans le champ de recherche de templates et sélectionnez-le comme indiqué ci-dessous :
- Sélectionnez
Create App.
Installer la bibliothèque cliente officielle
Pour installer la bibliothèque cliente, suivez les instructions de configuration en un clic ou via le gestionnaire de paquets ci-dessous.
Configuration en un clic
npm
yarn
Accéder à l'outil App Storage
- Accédez à l’onglet App Storage.
- Sélectionnez la vue
Commands dans l’onglet App Storage.
L’écran d’installation devrait ressembler à la capture d’écran suivante :Installer les dépendances
- Sélectionnez « JavaScript » dans le menu déroulant du langage de programmation en haut à gauche.
- Sélectionnez Install @replit/object-storage package.
- Une fois terminé, le texte du bouton devrait indiquer Package installed.
Utilisez cette option si votre application Replit utilise Node Package Manager (npm) pour gérer ses dépendances.Ouvrez l’outil Shell dans votre espace de travail et entrez la commande suivante :npm install @replit/object-storage
Utilisez cette option si votre application Replit utilise yarn pour gérer ses dépendances.Ouvrez l’outil Shell dans votre espace de travail et entrez la commande suivante :yarn add @replit/object-storage
Créer un bucket
Avant de stocker des fichiers, vous devez créer un bucket. Suivez les étapes ci-dessous pour créer un nouveau bucket :
- Accédez à l’outil App Storage
- Sélectionnez Create new bucket
- Entrez un nom pour le bucket dans le champ Name
- Sélectionnez Create bucket
Ajouter et exécuter le code d’exemple
Localiser index.ts
Ouvrez l’outil
Files depuis le dock gauche.Sélectionnez index.ts pour l’ouvrir dans un éditeur de fichiers. Ajouter le code client
Remplacez le contenu de index.ts par le code suivant :import { Client } from "@replit/object-storage";
const client = new Client();
// Téléverser un fichier texte contenant "Hello, World!"
const { ok: uploadOk, error: uploadError } = await client.uploadFromText(
"file.txt",
"Hello World!",
);
if (!uploadOk) console.error("Upload failed:", uploadError);
// Lister les fichiers dans le bucket
const { ok: listOk, value: listValue, error: listError } = await client.list();
if (!listOk) console.error("List failed:", listError);
else console.log("Bucket contents:", listValue);
// Récupérer et afficher le contenu du fichier téléversé
const {
ok: downloadOk,
value,
error: downloadError,
} = await client.downloadAsText("file.txt");
if (!downloadOk) console.error("Download failed:", downloadError);
else console.log("file.txt contents:", value);
Exécuter l'application
Sélectionnez Run pour exécuter le code d’exemple.Accédez à l’onglet Console pour afficher la sortie, qui devrait ressembler à ce qui suit :Bucket contents: [ { name: 'file.txt' } ]
file.txt contents: Hello World!
Vérifiez que le fichier file.txt apparaît dans votre bucket dans la vue Objects de
l’outil App Storage.Rechargez la page pour mettre à jour la liste des objets si file.txt n’apparaît pas.
Supprimer l’objet
Pour supprimer le fichier file.txt du bucket :
-
Remplacez le contenu de
index.ts par le code suivant :
import { Client } from "@replit/object-storage";
const client = new Client();
// Supprimer file.txt du bucket
const { ok: deleteOk, error: deleteError } = await client.delete("file.txt");
if (!deleteOk) console.error("Delete failed:", deleteError);
else console.log("Delete succeeded");
-
Sélectionnez Run pour exécuter le code d’exemple.
-
Accédez à l’onglet Console pour afficher la sortie, qui devrait ressembler à ce qui suit :
-
Vérifiez que l’objet
file.txt n’apparaît plus dans le bucket.
Prochaines étapes
Pour en savoir plus sur Replit App Storage, consultez les ressources suivantes :