Dynamique.js - Documentation JSQL.deleteFrom

Version:
Dernière mise à jour le 28/08/2018.

JSQL.deleteFrom

Supprime des données d'une base de données.

Synthaxe


						JSQL.deleteFrom(dbName, desc[, version]);

Si vous êtes amenés à insérer, supprimer ou modifier régulièrement des données d'une base de données, vous pouvez utiliser les méthodes fournies par la méthode JSQL. Des gains de performance pourront être observés du fait de la non-recherche de la version de la base de données à chaque manipulation.

Où:

dbName : nom de la base de données de laquelle il faut supprimer des données;
desc : objet définissant la suppression tel que:
- from : table depuis laquelle les données doivent être supprimées. Dans l'API IndexedDB, on parle de magasin (store) et non de table.
- where ou : condition de suppression des données. Cette valeur suit le même fonctionnement que la propriété where de la méthode insertInto.
version Facultatif: version de la base de données à utiliser, sous format système. Reportez-vous à la section Versionnage et délais maximum de transaction pour plus de détails sur les formats des versions. Par défaut, la version retournée par la méthode getDatabaseVersion sera utilisée.

Valeur de retour

Une promesse (Promise) est retournée. Celle-ci sera résolue lorsque la requête de sélection sera terminée. La valeur fournie comme valeur de résolution sera true si l'opération à réussie ou false dans le cas contraire.

Exemple

Exemple 1: Suppression de données

L'exemple ci-dessous supprime des données depuis une base de données.


							(async function() {
								/* la base est supposée créer */
								
								const del = await JSQL.deleteFrom("DB-TEST", {
									from 	: "myTable", 	// Pour l'API IndexedDB, on parle normalement de magasin ("store") et non de table
									where	: {
										type : "AND",
										condition : [
											[["t1", "id"], "=", 10],
											[["t1", "id"], ">", 20]
										]
									}
								});
								
								if(del) {
									alert("Suppression réussie !");
								}
								else {
									alert("Erreur !");
								}
							})();

Compatibilité

La prise en charge des Promise est nécessaire ainsi que le support de l'API IndexedDB.