feat(core): Add overrideRecordingName and configure to public API (…

…#372)

docs/server/request.md

@@ -246,3 +246,35 @@ A shortcut method that calls JSON.parse on the request's body.
 ```js
 req.jsonBody();
 ```
+
+### overrideRecordingName
+
+Override the recording name for the request.
+
+| Param         | Type     | Description            |
+| ------------- | -------- | ---------------------- |
+| recordingName | `String` | The new recording name |
+
+**Example**
+
+```js
+req.overrideRecordingName(req.hostname);
+```
+
+### configure
+
+Override configuration options for the request.
+
+| Param  | Type     | Description                           |
+| ------ | -------- | ------------------------------------- |
+| config | `Object` | [Configuration](configuration) object |
+
+**Example**
+
+```js
+req.configure({ recordFailedRequests: true });
+
+req.configure({ timing: Timing.relative(3.0) });
+
+req.configure({ logging: true });
+```

packages/@pollyjs/core/src/-private/request.js

@@ -66,13 +66,13 @@ export default class PollyRequest extends HTTPBase {
     this[ROUTE].applyFiltersWithArgs(this);
 
     // Handle config overrides defined by the route
-    this._configure(this[ROUTE].config());
+    this.configure(this[ROUTE].config());
 
     // Handle recording name override defined by the route
     const recordingName = this[ROUTE].recordingName();
 
     if (recordingName) {
-      this._overrideRecordingName(recordingName);
+      this.overrideRecordingName(recordingName);
     }
   }
 
@@ -219,13 +219,13 @@ export default class PollyRequest extends HTTPBase {
     this.aborted = true;
   }
 
-  _overrideRecordingName(recordingName) {
+  overrideRecordingName(recordingName) {
     validateRecordingName(recordingName);
     this.recordingName = recordingName;
     this.recordingId = guidForRecording(recordingName);
   }
 
-  _configure(config) {
+  configure(config) {
     validateRequestConfig(config);
     this.config = mergeConfigs(this[POLLY].config, this.config || {}, config);
   }