Class: HttpAdapter

HttpAdapter


new HttpAdapter(opts)

HttpAdapter class.

Method parameters:
Name Type Argument Description
opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
basePath String <optional>
''

TODO

debug Boolean <optional>
false

TODO

forceTrailingSlash Boolean <optional>
false

TODO

http Object <optional>
axios

TODO

httpConfig Object <optional>
{}

TODO

suffix String <optional>
''

TODO

useFetch Boolean <optional>
false

TODO

Details
Source
src/index.js, line 113

Extends

This class extends the Adapter class.

Members


_listeners

Event listeners attached to this Component. Do not modify. Use Component#on and Component#off instead.

Details
Type Since Source
Object 3.0.0 node_modules/js-data/src/Component.js, line 52
Inherited From:

basePath

Details
Type Source
String src/index.js, line 74

debug

Whether to log debugging information.

Details
Type Default value Source
Boolean
false
node_modules/js-data-adapter/src/index.js, line 74
Inherited From:

forceTrailingSlash

Details
Type Default value Source
Boolean
false
src/index.js, line 80

http

Details
Type Source
Function src/index.js, line 87

httpConfig

Details
Type Source
Object src/index.js, line 93

raw

Whether to return a more detailed response object.

Details
Type Default value Source
Boolean
false
node_modules/js-data-adapter/src/index.js, line 83
Inherited From:

suffix

Details
Type Source
String src/index.js, line 99

useFetch

Details
Type Default value Source
Boolean
false
src/index.js, line 105

Methods


<static> extend(props, classProps)

Create a subclass of this HttpAdapter:

Method parameters:
Name Type Argument Default Description
props Object <optional>
{}

Properties to add to the prototype of the subclass.

Properties
Name Type Argument Description
constructor Object <optional>

Provide a custom constructor function to be used as the subclass itself.

classProps Object <optional>
{}

Static properties to add to the subclass.

Return value:
Type Description
Constructor

Subclass of this HttpAdapter class.

Details
Since Source
3.0.0 src/index.js, line 1196
Example

// Normally you would do: import {HttpAdapter} from 'js-data-http'
// or: import {HttpAdapter} from 'js-data-http-node'
const JSDataHttp = require('js-data-http-node@3.0.0-beta.8')
const {HttpAdapter} = JSDataHttp
console.log('Using JSDataHttp v' + JSDataHttp.version.full)

// Extend the class using ES2015 class syntax.
class CustomHttpAdapterClass extends HttpAdapter {
  foo () { return 'bar' }
  static beep () { return 'boop' }
}
const customHttpAdapter = new CustomHttpAdapterClass()
console.log(customHttpAdapter.foo())
console.log(CustomHttpAdapterClass.beep())

// Extend the class using alternate method.
const OtherHttpAdapterClass = HttpAdapter.extend({
  foo () { return 'bar' }
}, {
  beep () { return 'boop' }
})
const otherHttpAdapter = new OtherHttpAdapterClass()
console.log(otherHttpAdapter.foo())
console.log(OtherHttpAdapterClass.beep())

// Extend the class, providing a custom constructor.
function AnotherHttpAdapterClass () {
  HttpAdapter.call(this)
  this.created_at = new Date().getTime()
}
HttpAdapter.extend({
  constructor: AnotherHttpAdapterClass,
  foo () { return 'bar' }
}, {
  beep () { return 'boop' }
})
const anotherHttpAdapter = new AnotherHttpAdapterClass()
console.log(anotherHttpAdapter.created_at)
console.log(anotherHttpAdapter.foo())
console.log(AnotherHttpAdapterClass.beep())

afterCount(mapper, props, opts, response)

Lifecycle method method called by count.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes count to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the count.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by count.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to count.

props Object

The props argument passed to count.

opts Object

The opts argument passed to count.

response Object | Response

Count or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterCount

Inherited From:

afterCreate(mapper, props, opts, response)

Lifecycle method method called by create.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes create to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the created record.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by create.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to create.

props Object

The props argument passed to create.

opts Object

The opts argument passed to create.

response Object | Response

Created record or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterCreate

Inherited From:

afterDEL(url, config, opts, response)

Method parameters:
Name Type Description
url String
config Object
opts Object
response Object
Details
Source
src/index.js, line 144

afterDestroy(mapper, id, opts, response)

Lifecycle method method called by destroy.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes destroy to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be undefined.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by destroy.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to destroy.

id String | Number

The id argument passed to destroy.

opts Object

The opts argument passed to destroy.

response undefined | Response

undefined or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterDestroy

Inherited From:

afterDestroyAll(mapper, query, opts, response)

Lifecycle method method called by destroyAll.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes destroyAll to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be undefined.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by destroyAll.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to destroyAll.

query Object

The query argument passed to destroyAll.

opts Object

The opts argument passed to destroyAll.

response undefined | Response

undefined or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterDestroyAll

Inherited From:

afterFind(mapper, id, opts, response)

Lifecycle method method called by find.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes find to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the found record, if any.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by find.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to find.

id String | Number

The id argument passed to find.

opts Object

The opts argument passed to find.

response Object | Response

The found record or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterFind

Inherited From:

afterFindAll(mapper, query, opts, response)

Lifecycle method method called by findAll.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes findAll to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the found records, if any.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by findAll.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to findAll.

query Object

The query argument passed to findAll.

opts Object

The opts argument passed to findAll.

response Array.<Object> | Response

The found records or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterFindAll

Inherited From:

afterGET(url, config, opts, response)

Method parameters:
Name Type Description
url String
config Object
opts Object
response Object
Details
Source
src/index.js, line 154

afterHTTP(config, opts, response)

Method parameters:
Name Type Description
config Object
opts Object
response Object
Details
Source
src/index.js, line 164

afterPOST(url, data, config, opts, response)

Method parameters:
Name Type Description
url String
data Object
config Object
opts Object
response Object
Details
Source
src/index.js, line 173

afterPUT(url, data, config, opts, response)

Method parameters:
Name Type Description
url String
data Object
config Object
opts Object
response Object
Details
Source
src/index.js, line 184

afterSum(mapper, field, query, opts, response)

Lifecycle method method called by sum.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes sum to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the sum.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by sum.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to sum.

field String

The field argument passed to sum.

query Object

The query argument passed to sum.

opts Object

The opts argument passed to sum.

response Object | Response

Count or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterSum

Inherited From:

afterUpdate(mapper, id, props, opts, response)

Lifecycle method method called by update.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes update to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the updated record.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by update.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to update.

id String | Number

The id argument passed to update.

props Object

The props argument passed to update.

opts Object

The opts argument passed to update.

response Object | Response

The updated record or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterUpdate

Inherited From:

afterUpdateAll(mapper, props, query, opts, response)

Lifecycle method method called by updateAll.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes updateAll to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the updated records, if any.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by updateAll.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to updateAll.

props Object

The props argument passed to updateAll.

query Object

The query argument passed to updateAll.

opts Object

The opts argument passed to updateAll.

response Array.<Object> | Response

The updated records or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterUpdateAll

Inherited From:

afterUpdateMany(mapper, records, opts, response)

Lifecycle method method called by updateMany.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes updateMany to wait for the Promise to resolve before continuing.

If opts.raw is true then response will be a detailed response object, otherwise response will be the updated records, if any.

response may be modified. You can also re-assign response to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by updateMany.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to updateMany.

records Array.<Object>

The records argument passed to updateMany.

opts Object

The opts argument passed to updateMany.

response Array.<Object> | Response

The updated records or Response, depending on the value of opts.raw.

Properties:
Name Type Description
opts.op String

afterUpdateMany

Inherited From:

beforeCount(mapper, query, opts)

Lifecycle method method called by count.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes count to wait for the Promise to resolve before continuing.

A thrown error or rejected Promise will bubble up and reject the Promise returned by count.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to count.

query Object

The query argument passed to count.

opts Object

The opts argument passed to count.

Properties:
Name Type Description
opts.op String

beforeCount

Inherited From:

beforeCreate(mapper, props, opts)

Lifecycle method method called by create.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes create to wait for the Promise to resolve before continuing.

props may be modified. You can also re-assign props to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by create.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to create.

props Object

The props argument passed to create.

opts Object

The opts argument passed to create.

Properties:
Name Type Description
opts.op String

beforeCreate

Inherited From:

beforeCreateMany(mapper, props, opts)

Lifecycle method method called by createMany.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes createMany to wait for the Promise to resolve before continuing.

props may be modified. You can also re-assign props to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by createMany.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to createMany.

props Array.<Object>

The props argument passed to createMany.

opts Object

The opts argument passed to createMany.

Properties:
Name Type Description
opts.op String

beforeCreateMany

Inherited From:

beforeDEL(url, config, opts)

Method parameters:
Name Type Description
url Object
config Object
opts Object
Details
Source
src/index.js, line 195

beforeDestroy(mapper, id, opts)

Lifecycle method method called by destroy.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes destroy to wait for the Promise to resolve before continuing.

A thrown error or rejected Promise will bubble up and reject the Promise returned by destroy.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to destroy.

id String | Number

The id argument passed to destroy.

opts Object

The opts argument passed to destroy.

Properties:
Name Type Description
opts.op String

beforeDestroy

Inherited From:

beforeDestroyAll(mapper, query, opts)

Lifecycle method method called by destroyAll.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes destroyAll to wait for the Promise to resolve before continuing.

A thrown error or rejected Promise will bubble up and reject the Promise returned by destroyAll.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to destroyAll.

query Object

The query argument passed to destroyAll.

opts Object

The opts argument passed to destroyAll.

Properties:
Name Type Description
opts.op String

beforeDestroyAll

Inherited From:

beforeFind(mapper, id, opts)

Lifecycle method method called by find.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes find to wait for the Promise to resolve before continuing.

A thrown error or rejected Promise will bubble up and reject the Promise returned by find.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to find.

id String | Number

The id argument passed to find.

opts Object

The opts argument passed to find.

Properties:
Name Type Description
opts.op String

beforeFind

Inherited From:

beforeFindAll(mapper, query, opts)

Lifecycle method method called by findAll.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes findAll to wait for the Promise to resolve before continuing.

A thrown error or rejected Promise will bubble up and reject the Promise returned by findAll.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to findAll.

query Object

The query argument passed to findAll.

opts Object

The opts argument passed to findAll.

Properties:
Name Type Description
opts.op String

beforeFindAll

Inherited From:

beforeGET(url, config, opts)

Method parameters:
Name Type Description
url Object
config Object
opts Object
Details
Source
src/index.js, line 204

beforeHTTP(config, opts)

Method parameters:
Name Type Description
config Object
opts Object
Details
Source
src/index.js, line 213

beforePOST(url, data, config, opts)

Method parameters:
Name Type Description
url Object
data Object
config Object
opts Object
Details
Source
src/index.js, line 221

beforePUT(url, data, config, opts)

Method parameters:
Name Type Description
url Object
data Object
config Object
opts Object
Details
Source
src/index.js, line 231

beforeSum(mapper, query, opts)

Lifecycle method method called by sum.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes sum to wait for the Promise to resolve before continuing.

A thrown error or rejected Promise will bubble up and reject the Promise returned by sum.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to sum.

query Object

The query argument passed to sum.

opts Object

The opts argument passed to sum.

Properties:
Name Type Description
opts.op String

beforeSum

Inherited From:

beforeUpdate(mapper, id, props, opts)

Lifecycle method method called by update.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes update to wait for the Promise to resolve before continuing.

props may be modified. You can also re-assign props to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by update.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to update.

id String | Number

The id argument passed to update.

props Object

The props argument passed to update.

opts Object

The opts argument passed to update.

Properties:
Name Type Description
opts.op String

beforeUpdate

Inherited From:

beforeUpdateAll(mapper, props, query, opts)

Lifecycle method method called by updateAll.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes updateAll to wait for the Promise to resolve before continuing.

props may be modified. You can also re-assign props to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by updateAll.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to updateAll.

props Object

The props argument passed to updateAll.

query Object

The query argument passed to updateAll.

opts Object

The opts argument passed to updateAll.

Properties:
Name Type Description
opts.op String

beforeUpdateAll

Inherited From:

beforeUpdateMany(mapper, props, opts)

Lifecycle method method called by updateMany.

Override this method to add custom behavior for this lifecycle hook.

Returning a Promise causes updateMany to wait for the Promise to resolve before continuing.

props may be modified. You can also re-assign props to another value by returning a different value or a Promise that resolves to a different value.

A thrown error or rejected Promise will bubble up and reject the Promise returned by updateMany.

Method parameters:
Name Type Description
mapper Object

The mapper argument passed to updateMany.

props Array.<Object>

The props argument passed to updateMany.

opts Object

The opts argument passed to updateMany.

Properties:
Name Type Description
opts.op String

beforeUpdateMany

Inherited From:

count(mapper, query, opts)

Retrieve the number of records that match the selection query.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

query Object

Selection query.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 327 Adapter#count

create(mapper, props, opts)

Create a new the record from the provided props.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

props Object

Properties to send as the payload.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 350 Adapter#create

createMany(mapper, props, opts)

Create multiple new records in batch.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

props Array

Array of property objects to send as the payload.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 370 Adapter#createMany

dbg(args)

Log the provided values at the "debug" level. Debug-level logs are only logged if Component#debug is true.

.dbg(...) is shorthand for .log('debug', ...).

Method parameters:
Name Type Argument Description
args * <optional>
<repeatable>

Values to log.

Details
Since Source
3.0.0 node_modules/js-data/src/Component.js, line 123
Inherited From:

DEL(url, config, opts)

Make an Http request to url according to the configuration in config.

Method parameters:
Name Type Argument Description
url String

Url for the request.

config Object <optional>

Http configuration that will be passed to HttpAdapter#HTTP.

opts Object <optional>

Configuration options.

Return value:
Type Description
Promise Unspecified
Details
Source
src/index.js, line 390

deserialize(mapper, response, opts)

Transform the server response object into the payload that will be returned to JSData.

Method parameters:
Name Type Description
mapper Object

The mapper used for the operation.

response Object

Response object from HttpAdapter#HTTP.

opts Object

Configuration options.

Return value:
Type Description
Object | Array

Deserialized data.

Details
Source
src/index.js, line 426

destroy(mapper, id, opts)

Destroy the record with the given primary key.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

id String | Number

Primary key of the record to destroy.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 451 Adapter#destroy

destroyAll(mapper, query, opts)

Destroy the records that match the selection query.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

query Object

Selection query.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 471 Adapter#destroyAll

emit(event, args)

Trigger an event on this Component.

Method parameters:
Name Type Argument Description
event String

Name of event to emit.

args * <optional>
<repeatable>

Arguments to pass to any listeners.

Details
Since Source
3.0.0 node_modules/js-data/src/Component.js, line 201
Inherited From:
Example

// import {Collection, DataStore} from 'js-data'
const JSData = require('js-data@3.0.0-beta.7')
const {Collection, DataStore} = JSData

const collection = new Collection()
collection.on('foo', function (msg) {
  console.log(msg)
})
collection.emit('foo', 'bar')

const store = new DataStore()
store.on('beep', function (msg) {
  console.log(msg)
})
store.emit('beep', 'boop')

error(args)

Log an error.

Method parameters:
Name Type Argument Description
args * <optional>
<repeatable>

Arguments to log.

Details
Source
src/index.js, line 493

fetch(config, opts)

Make an Http request using window.fetch.

Method parameters:
Name Type Argument Description
config Object

Request configuration.

Properties
Name Type Description
data Object

Payload for the request.

method String

Http method for the request.

headers Object

Headers for the request.

params Object

Querystring for the request.

url String

Url for the request.

opts Object <optional>

Configuration options.

Details
Source
src/index.js, line 506

find(mapper, id, opts)

Retrieve the record with the given primary key.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

id String | Number

Primary key of the record to retrieve.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 544 Adapter#find

findAll(mapper, query, opts)

Retrieve the records that match the selection query.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

query Object

Selection query.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 564 Adapter#findAll

GET(url, config, opts)

TODO

Method parameters:
Name Type Argument Description
url String

The url for the request.

config Object

Request configuration options.

opts Object <optional>

Configuration options.

Return value:
Type Description
Promise Unspecified
Details
Source
src/index.js, line 586

getEndpoint(mapper, id, opts)

Method parameters:
Name Type Description
mapper Object

TODO

id *

TODO

opts Boolean

TODO

Return value:
Type Description
String

Full path.

Details
Source
src/index.js, line 621

getOpt(opt, opts)

Resolve the value of the specified option based on the given options and this adapter's settings. Override with care.

Method parameters:
Name Type Argument Description
opt String

The name of the option.

opts Object <optional>

Configuration options.

Return value:
Type Description
*

The value of the specified option.

Inherited From:

getPath(method, mapper, id, opts)

Method parameters:
Name Type Argument Description
method String

TODO

mapper Object

TODO

id String | Number <nullable>

TODO

opts Object

Configuration options.

Details
Source
src/index.js, line 676

HTTP(config, opts)

Make an Http request.

Method parameters:
Name Type Argument Description
config Object

Request configuration options.

opts Object <optional>

Configuration options.

Return value:
Type Description
Promise Unspecified
Details
Source
src/index.js, line 715

loadBelongsTo()

Load a belongsTo relationship.

Override with care.

Return value:
Type Description
Promise Unspecified
Inherited From:

loadHasMany()

Load a hasMany relationship.

Override with care.

Return value:
Type Description
Promise Unspecified
Inherited From:

loadHasOne()

Load a hasOne relationship.

Override with care.

Return value:
Type Description
Promise Unspecified
Inherited From:

log(level, args)

Log the provided values. By default sends values to console[level]. Debug-level logs are only logged if Component#debug is true.

Will attempt to use appropriate console methods if they are available.

Method parameters:
Name Type Argument Description
level String

Log level.

args * <optional>
<repeatable>

Values to log.

Details
Since Source
3.0.0 node_modules/js-data/src/Component.js, line 133
Inherited From:

makeBelongsToForeignKey()

Return the foreignKey from the given record for the provided relationship.

Override with care.

Return value:
Type Description
* Unspecified
Inherited From:

makeHasManyForeignKey()

Return the foreignKey from the given record for the provided relationship.

There may be reasons why you may want to override this method, like when the id of the parent doesn't exactly match up to the key on the child.

Override with care.

Return value:
Type Description
* Unspecified
Inherited From:

makeHasManyForeignKeys()

Return the foreignKeys from the given record for the provided relationship.

Override with care.

Return value:
Type Description
* Unspecified
Inherited From:

makeHasManyLocalKeys()

Return the localKeys from the given record for the provided relationship.

Override with care.

Return value:
Type Description
* Unspecified
Inherited From:

off(event, listener)

Remove an event listener from this Component. If no listener is provided, then all listeners for the specified event will be removed. If no event is specified then all listeners for all events will be removed.

Method parameters:
Name Type Argument Description
event String <optional>

Name of event to unsubsribe to.

listener Function <optional>

Listener to remove.

Details
Since Source
3.0.0 node_modules/js-data/src/Component.js, line 179
Inherited From:
Examples
// Remove a particular listener for a particular event
collection.off('add', handler)
// Remove all listeners for a particular event
record.off('change')
// Remove all listeners to all events
store.off()

on(event, listener, ctx)

Register a new event listener on this Component.

Method parameters:
Name Type Argument Description
event String

Name of event to subsribe to.

listener Function

Listener function to handle the event.

ctx * <optional>

Optional content in which to invoke the listener.

Details
Since Source
3.0.0 node_modules/js-data/src/Component.js, line 146
Inherited From:
Examples
// Listen for all "afterCreate" events in a DataStore
store.on('afterCreate', (mapperName, props, opts, result) => {
  console.log(mapperName) // "post"
  console.log(props.id) // undefined
  console.log(result.id) // 1234
})
store.create('post', { title: 'Modeling your data' }).then((post) => {
  console.log(post.id) // 1234
})
// Listen for the "add" event on a collection
collection.on('add', (records) => {
  console.log(records) // [...]
})
// Listen for "change" events on a record
post.on('change', (record, changes) => {
  console.log(changes) // { changed: { title: 'Modeling your data' } }
})
post.title = 'Modeling your data'

POST(url, data, config, opts)

TODO

Method parameters:
Name Type Argument Description
url *

TODO

data Object

TODO

config Object

TODO

opts Object <optional>

Configuration options.

Return value:
Type Description
Promise Unspecified
Details
Source
src/index.js, line 778

PUT(url, data, config, opts)

TODO

Method parameters:
Name Type Argument Description
url *

TODO

data Object

TODO

config Object

TODO

opts Object <optional>

Configuration options.

Return value:
Type Description
Promise Unspecified
Details
Source
src/index.js, line 815

queryTransform(mapper, params, opts)

TODO

Method parameters:
Name Type Description
mapper Object

TODO

params *

TODO

opts *

TODO

Return value:
Type Description
*

Transformed params.

Details
Source
src/index.js, line 852

respond(response, opts)

Method parameters:
Name Type Description
response Object

Response object.

opts Object

Configuration options. return {Object} If opts.raw == true then return response, else return response.data.

Inherited From:

responseError(err, config, opts)

Error handler invoked when the promise returned by HttpAdapter#http is rejected. Default implementation is to just return the error wrapped in a rejected Promise, aka rethrow the error. HttpAdapter#http is called by HttpAdapter#HTTP.

Method parameters:
Name Type Description
err *

The error that HttpAdapter#http rejected with.

config Object

The config argument that was passed to HttpAdapter#HTTP.

opts *

The opts argument that was passed to HttpAdapter#HTTP.

Return value:
Type Description
Promise Unspecified
Details
Source
src/index.js, line 873

serialize(mapper, data, opts)

TODO

Method parameters:
Name Type Description
mapper Object

TODO

data Object

TODO

opts *

TODO

Return value:
Type Description
*

Serialized data.

Details
Source
src/index.js, line 890

sum(mapper, field, query, opts)

Retrieve the sum of the field of the records that match the selection query.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

field String

The field to sum.

query Object

Selection query.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 911 Adapter#sum

update(mapper, id, props, opts)

TODO

Method parameters:
Name Type Argument Description
mapper Object

TODO

id *

TODO

props *

TODO

opts Object <optional>

Configuration options.

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 938 Adapter#update

updateAll(mapper, props, query, opts)

TODO

Method parameters:
Name Type Argument Description
mapper Object

TODO

props Object

TODO

query Object

TODO

opts Object <optional>

Configuration options.

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 957 Adapter#updateAll

updateMany(mapper, records, opts)

Update multiple records in batch.

HttpAdapter#beforeUpdateMany will be called before calling HttpAdapter#PUT. HttpAdapter#afterUpdateMany will be called after calling HttpAdapter#PUT.

Method parameters:
Name Type Argument Description
mapper Object

The mapper.

records Array

Array of property objects to send as the payload.

opts Object <optional>

Configuration options.

Properties
Name Type Argument Default Description
params String <optional>

TODO

suffix String <optional>
HttpAdapter#suffix

TODO

Return value:
Type Description
Promise Unspecified
Details
Source Overrides
src/index.js, line 978 Adapter#updateMany