@@ -1102,6 +1102,34 @@ utils.addHiddenPropsToTarget(HttpAdapter.prototype, {
11021102/**
11031103 * Add an Http actions to a mapper.
11041104 *
1105+ * @example
1106+ * // CommonJS
1107+ * var JSData = require('js-data')
1108+ * // It is recommended to use DataStore in the browser
1109+ * var DataStore = JSData.DataStore
1110+ *
1111+ * var JSDataHttp = require('js-data-http')
1112+ * var HttpAdapter = JSDataHttp.HttpAdapter
1113+ * var addAction = JSDataHttp.addAction
1114+ *
1115+ * var adapter = new HttpAdapter()
1116+ * var store = new DataStore()
1117+ *
1118+ * store.registerAdapter('http', adapter, { default: true })
1119+ * store.defineMapper('school')
1120+ *
1121+ * // GET /reports/schools/:school_id/teachers
1122+ * addAction('getTeacherReports', {
1123+ * basePath: 'reports/schools',
1124+ * pathname: 'teachers',
1125+ * method: 'GET'
1126+ * })(store.getMapper('school'))
1127+ *
1128+ * // /reports/schools/1234/teachers
1129+ * store.getMapper('school').getTeacherReports(1234).then(function (response) {
1130+ * // ...
1131+ * })
1132+ *
11051133 * @name module:js-data-http.addAction
11061134 * @method
11071135 * @param {string } name Name of the new action.
@@ -1152,7 +1180,7 @@ exports.addAction = function addAction (name, opts) {
11521180 }
11531181 config . method = config . method || 'GET'
11541182 config . mapper = self . name
1155- utils . deepMixIn ( config ) ( _opts )
1183+ utils . deepMixIn ( config , _opts )
11561184 return utils . resolve ( config )
11571185 . then ( _opts . request || opts . request )
11581186 . then ( function ( config ) { return adapter . HTTP ( config ) } )
@@ -1172,6 +1200,36 @@ exports.addAction = function addAction (name, opts) {
11721200 * Add multiple Http actions to a mapper. See {@link HttpAdapter.addAction} for
11731201 * action configuration options.
11741202 *
1203+ * @example
1204+ * // CommonJS
1205+ * var JSData = require('js-data')
1206+ * // It is recommended to use DataStore in the browser
1207+ * var DataStore = JSData.DataStore
1208+ *
1209+ * var JSDataHttp = require('js-data-http')
1210+ * var HttpAdapter = JSDataHttp.HttpAdapter
1211+ * var addActions = JSDataHttp.addActions
1212+ *
1213+ * var adapter = new HttpAdapter()
1214+ * var store = new DataStore()
1215+ *
1216+ * store.registerAdapter('http', adapter, { default: true })
1217+ * store.defineMapper('school')
1218+ *
1219+ * addActions({
1220+ * // GET /reports/schools/:school_id/teachers
1221+ * getTeacherReports: {
1222+ * basePath: 'reports/schools',
1223+ * pathname: 'teachers',
1224+ * method: 'GET'
1225+ * }
1226+ * })(store.getMapper('school'))
1227+ *
1228+ * // /reports/schools/1234/teachers
1229+ * store.getMapper('school').getTeacherReports(1234).then(function (response) {
1230+ * // ...
1231+ * })
1232+ *
11751233 * @name module:js-data-http.addActions
11761234 * @method
11771235 * @param {Object.<string, Object> } opts Object where the key is an action name
@@ -1182,7 +1240,7 @@ exports.addAction = function addAction (name, opts) {
11821240exports . addActions = function addActions ( opts ) {
11831241 opts || ( opts = { } )
11841242 return function ( mapper ) {
1185- utils . forOwn ( mapper , function ( value , key ) {
1243+ utils . forOwn ( opts , function ( value , key ) {
11861244 exports . addAction ( key , value ) ( mapper )
11871245 } )
11881246 return mapper
@@ -1211,22 +1269,25 @@ exports.version = '<%= version %>'
12111269 * of `js-data-http` that does not bundle `axios` is registered in NPM and Bower
12121270 * as `js-data-fetch`.
12131271 *
1214- * __Script tag__:
1215- * ```javascript
1216- * window.HttpAdapter
1217- * ```
1218- * __CommonJS__:
1219- * ```javascript
1220- * var HttpAdapter = require('js-data-http')
1221- * ```
1222- * __ES6 Modules__:
1223- * ```javascript
1224- * import HttpAdapter from 'js-data-http'
1225- * ```
1226- * __AMD__:
1227- * ```javascript
1228- * define('myApp', ['js-data-http'], function (HttpAdapter) { ... })
1229- * ```
1272+ * @example <caption>Script tag</caption>
1273+ * var HttpAdapter = window.JSDataHttp.HttpAdapter
1274+ * var adapter = new HttpAdapter()
1275+ *
1276+ * @example <caption>CommonJS</caption>
1277+ * var HttpAdapter = require('js-data-Http').HttpAdapter
1278+ * var adapter = new HttpAdapter()
1279+ *
1280+ * @example <caption>ES2015 Modules</caption>
1281+ * import {HttpAdapter} from 'js-data-Http'
1282+ * const adapter = new HttpAdapter()
1283+ *
1284+ * @example <caption>AMD</caption>
1285+ * define('myApp', ['js-data-Http'], function (JSDataHttp) {
1286+ * var HttpAdapter = JSDataHttp.HttpAdapter
1287+ * var adapter = new HttpAdapter()
1288+ *
1289+ * // ...
1290+ * })
12301291 *
12311292 * @module js-data-http
12321293 */
0 commit comments