Question 1

How do I handle errors in Restangular?

Accepted Answer

Use the second argument of the .then() promise method to catch errors, as Restangular returns promises. For example, .getList().then(successFn, function(response) { console.log('Error:', response.status); }). You can also set global error interceptors with setErrorInterceptor.

Question 2

How can I send files with Restangular?

Accepted Answer

Use customPOST with specific HTTP configurations: set withHttpConfig({transformRequest: angular.identity}) and set headers to {'Content-Type': undefined} to enable multipart/form-data. This is detailed in the FAQ section for file uploads.

Question 3

Restangular vs Angular $resource: which is better?

Accepted Answer

Restangular is better for complex nested resources and promise-based workflows, as it avoids $resource bugs like trailing slash issues and supports all HTTP methods. However, $resource is built into AngularJS and may suffice for simpler, standard REST APIs without extra dependencies.

Question 4

How to configure Restangular for APIs with wrapped responses?

Accepted Answer

Use addResponseInterceptor to extract data from metadata-wrapped server responses. For example, if your API returns { data: [...], meta: {} }, configure the interceptor to return data.data and attach meta as needed, as shown in the FAQ example.

Question 5

Can Restangular be used with Angular 2+?

Accepted Answer

No, the core Restangular project only supports AngularJS. For Angular 2+, you must use ngx-restangular, a separate fork with different maintainers, which may have limited features or support compared to the original.

Question 6

How to add custom methods to Restangular objects?

Accepted Answer

Use addRestangularMethod on elements or extendModel/extendCollection for models and collections. For example, building.addRestangularMethod('evaluate', 'get', 'evaluate') adds a custom GET method, as demonstrated in the Creating new Restangular Methods section.

restangular

What is restangular?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions