Merge pull request #483 from Esri/f/dataset-requestOptions

pass dataset request options to queryFeatures()

Author: tomwayson

packages/cedar-amcharts/CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
-## Unreleased
+## 1.0.0
 - Add tabindex properties to fillInSpec
 
 ## 1.0.0-rc.1

packages/cedar/CHANGELOG.md

@@ -5,6 +5,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+### Added
+- pass dataset request options to `queryFeatures()`
+
+## [1.0.1]
+
 ### Fixed
 - make @esri/arcis-rest-* `peerDependencies` of @esri/cedar
 ### Changed
@@ -282,7 +287,8 @@ Baseline version.
 - Basic interaction events: on, off, clicked
 - Map to Chart interaction demos
 
-[Unreleased]: https://github.com/Esri/cedar/compare/v1.0.0...master
+[Unreleased]: https://github.com/Esri/cedar/compare/v1.0.1...master
+[1.0.1]: https://github.com/Esri/cedar/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/Esri/cedar/compare/v1.0.0-rc.1...v1.0.0
 [1.0.0-rc.1]: https://github.com/Esri/cedar/compare/v1.0.0-beta.9...v1.0.0-rc.1
 [1.0.0-beta.9]: https://github.com/Esri/cedar/compare/v1.0.0-beta.8...v1.0.0-beta.9

packages/cedar/src/common.ts

@@ -1,3 +1,4 @@
+import { IRequestOptions } from '@esri/arcgis-rest-request'
 import { IFeatureSet } from '@esri/arcgis-rest-types'
 
 export interface IField {
@@ -72,6 +73,10 @@ export interface IDataset {
    * Values in these fields will be decoded using the coded value domain specified.
    */
   domains?: IDomains
+  /**
+   * Options to use for requests to this dataset. See: https://esri.github.io/arcgis-rest-js/api/request/IRequestOptions/
+   */
+  requestOptions?: IRequestOptions
 }
 
 /**

packages/cedar/src/query/query.ts

@@ -17,13 +17,15 @@ export function queryDatasets(datasets: IDataset[]) {
       datasets.forEach((dataset, i) => {
       // only query datasets that don't have inline data
       if (dataset.url) {
+        const { url, name, query, requestOptions } = dataset
         // TODO: make name required on datasets, or required if > 1 dataset?
-        names.push(dataset.name || `dataset${i}`)
+        names.push(name || `dataset${i}`)
 
-        const queryParams = createQueryParams(dataset.query)
+        const params = { ...(requestOptions && requestOptions.params), ...createQueryParams(query) }
         const options: IQueryFeaturesOptions = {
-          url: dataset.url,
-          params: queryParams
+          ...requestOptions,
+          url,
+          params,
         }
         if (config.fetch && typeof config.fetch === 'function') {
           // we are configured to use a custom fetch implementation

packages/cedar/test/query/query.spec.ts

@@ -1,6 +1,7 @@
 // NOTE: this is auto-mocked in __mocks__
 import { queryFeatures, decodeValues } from '@esri/arcgis-rest-feature-layer'
 import {} from 'jest'
+import { IDataset } from '../../src/common'
 import config from '../../src/config'
 import { queryDatasets } from '../../src/query/query'
 import { createQueryParams } from '../../src/query/url'
@@ -88,6 +89,33 @@ describe('when querying datasets', () => {
         })
       })
     })
+    describe('when that dataset has requestOptions', () => {
+      const datasets = definitions.bar.datasets
+      it('should merge them into those passed to queryFeatures', () => {
+        const httpMethod = 'POST'
+        const dataset: IDataset = {
+          ...datasets[0],
+          requestOptions: {
+            // override default HTTP method
+            httpMethod,
+            params: {
+              // invalid param should NOT be used
+              f: 'html'
+            }
+          }
+        }
+        return queryDatasets([ dataset ]).then((datasetsData) => {
+          // verify that it called queryFeatures once w/ the right parameters
+          expect(mockQueryFeatures.mock.calls.length).toEqual(1)
+          const requestOptions = mockQueryFeatures.mock.calls[0][0]
+          verifyRequestOptions(dataset, requestOptions)
+          expect(requestOptions.httpMethod).toEqual(httpMethod)
+          expect(datasetsData).toEqual({
+            Number_of_SUM: mockQueryResponse
+          })
+        })
+      })
+    })
   })
   describe('when multiple datasets', () => {
     beforeEach(() => {