Registry / devops / backendless-request

backendless-request

JSON →
library0.9.0jsnpmunverified

Simple REST client for Node.js and browser (v0.9.0). Lightweight (11KB min), with promise-based methods (GET, POST, PUT, DELETE, PATCH), query params, request body (JSON/form), caching with cache tags, custom XMLHttpRequest, and logging. Designed for use standalone, via script tag, or as part of Backendless JS-SDK. Minimal dependencies, no need for external libraries like axios or fetch polyfills in older browsers. Low release cadence.

devops
npm install backendless-request
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · BACKENDLESS-REQUES
B
backendless-request
devopsjavascriptv0.9.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

BackendlessRequest
✓ import BackendlessRequest from 'backendless-request'
✗ const { BackendlessRequest } = require('backendless-request')
Default export, not named. CommonJS: const BackendlessRequest = require('backendless-request').
BackendlessRequest.get
✓ BackendlessRequest.get('url').then(...)
✗ BackendlessRequest.GET('url')
Method names are lowercase: get, post, put, delete, patch.
Backendless.Request (when using Backendless JS-SDK)
✓ Backendless.Request.get('url')
✗ Backendless.request.get('url')
Capital R in Request. Only available if Backendless JS-SDK is loaded.
Script global
✓ <script src='backendless-request.js'></script> then use BackendlessRequest globally
✗ window.BackendlessRequest()
It's a constructor-like object, not a function. Access methods directly on BackendlessRequest.

Demonstrates basic GET and POST requests with query parameters using promise-based chaining.

const BackendlessRequest = require('backendless-request'); BackendlessRequest.get('https://jsonplaceholder.typicode.com/posts/1') .then(response => { console.log('Response:', response); }) .catch(error => { console.error('Error:', error); }); BackendlessRequest.post('https://jsonplaceholder.typicode.com/posts', { title: 'foo', body: 'bar', userId: 1 }) .query({ userId: 1 }) .then(response => { console.log('Created:', response); }) .catch(error => { console.error('Error:', error); });
Debug
Known issues
gotchaThe 'delete' method uses a reserved word in strict mode; it works but may confuse some parsers.
fix
Use BackendlessRequest.delete directly. Custom wrappers are not needed.
affects: >=0.1.0
gotchaThe library uses XMLHttpRequest in browser, which may not support streaming or progress events beyond basic onprogress.
fix
For advanced streaming, consider alternatives like fetch API or axios.
affects: >=0.1.0
gotchaCache tags are only effective if the server supports cache headers (ETag, Cache-Control). Caching is client-side and does not persist across page reloads.
fix
Use cache tags only for brief session-level caching. Combine with server-side cache headers for best results.
affects: >=0.1.0
gotchaLogging is enabled by default and prints to console; to disable, you must set BackendlessRequest.logging = false before any request.
fix
Set BackendlessRequest.logging = false at start of your app.
affects: >=0.1.0
gotchaThe library does not handle HTTP errors as promise rejections by default; it resolves with the response object even for 4xx/5xx. You must check response.status.
fix
Add a .then() that checks response.status < 400; otherwise throw an error.
affects: >=0.1.0
Errors
Common errors & fixes
TypeError: Cannot read property 'get' of undefined
Using named import instead of default import, e.g., import { BackendlessRequest } from 'backendless-request'
fix
Use default import: import BackendlessRequest from 'backendless-request'
Uncaught ReferenceError: BackendlessRequest is not defined
Script not loaded or loaded after script tag usage
fix
Ensure script tag loads before your code, e.g., order of script tags.
Error: Request failed with status 404
The library resolves promise even for non-2xx responses; you must manually check status
fix
Check response.status inside .then() and reject if >= 400.
Upgrade
Version history
0.9.0latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
11 hits · last 30 days
node
10
Resources
githubhttps://github.com/Backendless/Request ↗
packagebackendless-request ↗
homepagehttps://github.com/Backendless/Request#readme ↗
backendless-request — npm install backendless-request · libregistry