Skip to content

useDelete

This hook allows calling dataProvider.delete() when the callback is executed and deleting a single record based on its id.

const [deleteOne, { data, isPending, error }] = useDelete(
resource,
{ id, previousData, meta },
options
);

The deleteOne() method can be called with the same parameters as the hook:

deleteOne(
resource,
{ id, previousData },
options
);

So, should you pass the parameters when calling the hook, or when executing the callback? It’s up to you; but if you have the choice, we recommend passing the parameters when calling the deleteOne callback (second example below).

// set params when calling the hook
import { useDelete, useRecordContext } from 'ra-core';
const DeleteButton = () => {
const record = useRecordContext();
const [deleteOne, { isPending, error }] = useDelete(
'likes',
{ id: record.id, previousData: record }
);
const handleClick = () => {
deleteOne();
}
if (error) { return <p>ERROR</p>; }
return <button disabled={isPending} onClick={handleClick}>Delete</button>;
};
// set params when calling the deleteOne callback
import { useDelete, useRecordContext } from 'ra-core';
const DeleteButton = () => {
const record = useRecordContext();
const [deleteOne, { isPending, error }] = useDelete();
const handleClick = () => {
deleteOne(
'likes',
{ id: record.id , previousData: record }
);
}
if (error) { return <p>ERROR</p>; }
return <button disabled={isPending} onClick={handleClick}>Delete</button>;
};

The useDelete hook accepts a generic parameter for the record type and another for the error type:

useDelete<Product, Error>(undefined, undefined, {
onError: (error) => {
// TypeScript knows that error is of type Error
},
onSettled: (data, error) => {
// TypeScript knows that data is of type Product
// TypeScript knows that error is of type Error
},
})