Skip to main content

Data deletion

Hooks

const [del, loading] = useDelete(url, options);
const [del, loading] = useSecureDelete(url, options);

usePut hook executes an ajax PUT request and returns back the payload sent by the server.

useSecureDelete is similar to useDelete but adds a Bearer authorization header that contains the token received and stored by useLoginService in the redux store

note

The data are stored in the state of the component and not in the redux store.

Parameters

Inputs

Mandatory parameters are marked with a *

ParameterTypeDescription
url*stringthe URL to which the Ajax request is sent
optionsAn optional object to specify additional options
onSuccessAppSuccessCallback
  • if onSuccess is a function, this function is called on a successful GET (Promise / async allowed)
  • if onError is a string then the value must be an URL. The hook does a redirect to this URL on a successful GET
Defaults to: Nothing is done on a successful GET
onErrorAppErrorCallback
  • if onError is a function, this function is called if the HTTP response is a 4xx or 5xx (Promise / async allowed)
  • if onError is a string then the value must be an URL. The hook does a redirect to this URL
Defaults to: the hook sends a notification to the error topic
delayLoadingnumberThe number of milliseconds to wait before setting the loading flag to true. This value is useful to not display a loading indicator if the request is executed rapidly.

Defaults to: 0
authobjectContains the credentials to be sent in the request. See Auth.

Defaults to: no credentials sent
headersobjectthe HTTP headers to add in the request

Defaults to: no headers added in the request
paramsobjectParams in the url.
Example: if the user is /user/:userId, options.params could be {userId: '1'}
queryobjectQuery params to add the URL.
Example: If the final url is /users?name=Doe, options.query will be {name: 'Doe'}
note

The options object also accept these additionnal parameters supported by the fetch API

headers,
credentials,
cache,
redirect,
referrer,
referrerPolicy,
integrity,
keepalive,
signal

Outputs

ParameterTypeDescription
del(options) => Promisedel is a function that executes the ajax DELETE request.
>options is the same object as the one used for usePut. Use this object to override an option passed to useDelete
loadingbooleanA flag to indicate if the ajax request is pending

Examples

examples/cra-data/src/pages/index.tsx
loading...