node-turbo 1.0.1 → 1.1.0

package/lib/turbo-readable.js

@@ -9,7 +9,7 @@ const debug = db('node-turbo:readable');
  * This class represents a readable stream which reads
  * messages/elements from a Turbo Stream instance.
  * 
- * @extends {stream~Readable}
+ * @extends {node:stream~Readable}
  * @since 1.0.0
  */
 export class TurboReadable extends Readable {
@@ -18,6 +18,7 @@ export class TurboReadable extends Readable {
 	 * The Turbo Stream instance to create the readable stream for.
 	 * 
 	 * @type {TurboStream}
+	 * @since 1.0.0
 	 */
 	_turboStream;
 
@@ -34,6 +35,7 @@ export class TurboReadable extends Readable {
 	 * @param {TurboStream} turboStream - The Turbo Stream instance to create the readable stream for.
 	 * @param {Object} [opts] - The options for the readable stream.
 	 * @throws {Error} if `turboStream` is not a TurboStream instance
+	 * @since 1.0.0
 	 */
 	constructor(turboStream, opts) {
 		debug('new TurboReadable()', opts);
@@ -61,6 +63,7 @@ export class TurboReadable extends Readable {
 	 * Pushes a Turbo Stream element into the read queue.
 	 * 
 	 * @param {TurboStreamElement} el - The Turbo Stream element.
+	 * @since 1.0.0
 	 */
 	_pushElement(el) {
 		debug('_pushElement()');
@@ -73,6 +76,7 @@ export class TurboReadable extends Readable {
 	 * as handler for the `element` event. 
 	 * 
 	 * @type {Function}
+	 * @since 1.0.0
 	 */
 	_boundPush = this._pushElement.bind(this);
 
@@ -82,6 +86,7 @@ export class TurboReadable extends Readable {
 	 * This implementation does nothing.
 	 * (Normally, push data would be pushed into the read queue here.)
 	 * 
+	 * @since 1.0.0
 	 * @todo Do we need backpressure handling?
 	 */
 	_read() {
@@ -94,6 +99,7 @@ export class TurboReadable extends Readable {
 	 * for the event `element` is removed and the configuration restored.
 	 * 
 	 * @param {Error} err - The error object, if thrown.
+	 * @since 1.0.0
 	 */
 	_destroy(err) {
 		debug('_destroy()', err);
@@ -115,7 +121,8 @@ export class TurboReadable extends Readable {
 	 * Pushes `null` to the readable buffer to signal the end of the input.
 	 * 
 	 * @todo Should we call this end() or is this confusing because normally  
-	 * only writable streams have this function.
+	 *  only writable streams have this function.
+	 * @since 1.0.0
 	 */
 	done() {
 		debug('done()');

package/lib/turbo-stream-element.js

@@ -13,31 +13,20 @@ import { AttributeMissingError, AttributeMalformedError, AttributeInvalidError }
  export class TurboStreamElement extends TurboElement {
 
 	/**
-	 * Validates the attributes. `attributes.target` (or `attributes.targets`) and `attributes.action` 
-	 * are mandatory. Gets called by the constructor.
+	 * Validates the attributes. `attributes.action` is mandatory. 
+	 * `attributes.target` (or `attributes.targets`) is mandatory for any action but 'refresh'. 
+	 * Gets called by the constructor.
 	 * 
 	 * @throws {AttributeMissingError} when mandatory attributes are missing.
 	 * @throws {AttributeMalformedError} when mandatory attributes are malformed.
 	 * @throws {AttributeInvalidError} when attributes are invalid.
+	 * @since 1.0.0
 	 */
 	validate() {
 		if (typeof this.attributes === 'undefined' || !isPlainObject(this.attributes)) {
 			throw new AttributeMissingError('TurboStream: Attributes are missing.');
 		}
 
-		if (!('target' in this.attributes) && !('targets' in this.attributes)) {
-			throw new AttributeMissingError('TurboStream: Attribute "target" or "targets" is missing.');
-		}
-
-		if ('target' in this.attributes && 'targets' in this.attributes) {
-			throw new AttributeInvalidError('TurboStream: Attributes "target" and "targets" exclude each other.');
-		}
-
-		if ((typeof this.attributes.target !== 'string' || this.attributes.target.length === 0) && 
-			(typeof this.attributes.targets !== 'string' || this.attributes.targets.length === 0)) {
-			throw new AttributeMalformedError('TurboStream: Attribute "target"/"targets" must be a string with non-zero length.');
-		}
-
 		if (!('action' in this.attributes)) {
 			throw new AttributeMissingError('TurboStream: Attribute "action" is missing.');
 		}
@@ -45,22 +34,39 @@ import { AttributeMissingError, AttributeMalformedError, AttributeInvalidError }
 		if (typeof this.attributes.action !== 'string' || this.attributes.action.length === 0) {
 			throw new AttributeMalformedError('TurboStream: Attribute "action" must be a string with non-zero length.');
 		}
+
+		if (this.attributes.action !== 'refresh') {
+			if (!('target' in this.attributes) && !('targets' in this.attributes)) {
+				throw new AttributeMissingError('TurboStream: Attribute "target" or "targets" is missing.');
+			}
+
+			if ('target' in this.attributes && 'targets' in this.attributes) {
+				throw new AttributeInvalidError('TurboStream: Attributes "target" and "targets" exclude each other.');
+			}
+
+			if ((typeof this.attributes.target !== 'string' || this.attributes.target.length === 0) && 
+				(typeof this.attributes.targets !== 'string' || this.attributes.targets.length === 0)) {
+				throw new AttributeMalformedError('TurboStream: Attribute "target"/"targets" must be a string with non-zero length.');
+			}
+		}
 	}
 
 
 	/**
 	 * Renders this Turbo Stream element as HTML string. Omits `<template>[content]<template>` when the attribute 
-	 * `action` is 'remove'.
+	 * `action` is 'remove' or 'refresh'.
 	 * 
 	 * @returns {String} The rendered HTML fragment.
 	 * @see https://turbo.hotwired.dev/handbook/streams#stream-messages-and-actions
+	 * @since 1.0.0
 	 */
 	render() {
-		if (this.attributes.action === 'remove') {
-			return `<turbo-stream ${this.renderAttributesAsHtml()}></turbo-stream>`;
-		}
-		else {
-			return `<turbo-stream ${this.renderAttributesAsHtml()}><template>${this.content}</template></turbo-stream>`;
+		switch (this.attributes.action) {
+			case 'remove':
+			case 'refresh':
+				return `<turbo-stream ${this.renderAttributesAsHtml()}></turbo-stream>`;
+			default:
+				return `<turbo-stream ${this.renderAttributesAsHtml()}><template>${this.content}</template></turbo-stream>`;
 		}
 	}
 

package/lib/turbo-stream.js

@@ -9,7 +9,7 @@ const debug = db('node-turbo:turbostream');
 /**
  * A Turbo Stream message.
  * 
- * @extends {events~EventEmitter}
+ * @extends {node:events~EventEmitter}
  * @since 1.0.0
  */
 export class TurboStream extends EventEmitter {
@@ -19,6 +19,7 @@ export class TurboStream extends EventEmitter {
 	 * 
 	 * @type {Object<String, String>}
 	 * @property {Boolean} buffer - Should elements be added to the buffer (default: true)?
+	 * @since 1.0.0
 	 */
 	config = {
 		buffer: true
@@ -29,6 +30,7 @@ export class TurboStream extends EventEmitter {
 	 * Array of buffered elements. Gets filled if `config.buffer` is `true`.
 	 * 
 	 * @type {Array}
+	 * @since 1.0.0
 	 */
 	elements = [];
 	
@@ -39,17 +41,20 @@ export class TurboStream extends EventEmitter {
 	 * @see https://turbo.hotwired.dev/handbook/streams#streaming-from-http-responses
 	 * @type {String}
 	 * @static
+	 * @since 1.0.0
 	 */
 	static MIME_TYPE = 'text/vnd.turbo-stream.html';
 
 
 	/**
-	 * List of all supported actions:
-	 * 'append', 'prepend', 'replace', 'update', 'remove', 'before' and 'after'.
+	 * List of all supported official actions:
+	 * `append`, `prepend`, `replace`, `update`, `remove`, `before`, `after`
+	 * and `refresh`.
 	 * 
 	 * @see https://turbo.hotwired.dev/handbook/streams#stream-messages-and-actions
 	 * @type {Array}
 	 * @static
+	 * @since 1.0.0
 	 */
 	static ACTIONS = [
 		'append',
@@ -58,7 +63,9 @@ export class TurboStream extends EventEmitter {
 		'update',
 		'remove',
 		'before',
-		'after'
+		'after',
+		'morph',
+		'refresh'
 	];
 
 
@@ -66,6 +73,7 @@ export class TurboStream extends EventEmitter {
 	 * The number of buffered Turbo Stream elements.
 	 *
 	 * @type {Number}
+	 * @since 1.0.0
 	 */
 	get length() {
 		return this.elements.length;
@@ -78,6 +86,7 @@ export class TurboStream extends EventEmitter {
 	 * 
 	 * @param {Object<String, String>} [attributes] - The attributes of this element.
 	 * @param {String} [content] - The HTML content of this element.
+	 * @since 1.0.0
 	 */
 	constructor(attributes, content) {
 		super();
@@ -94,6 +103,7 @@ export class TurboStream extends EventEmitter {
 	 * @param {Object} config - New configuration.
 	 * @emits config
 	 * @returns {TurboStream} The instance for chaining.
+	 * @since 1.0.0
 	 */
 	updateConfig(config) {
 		if (config) {
@@ -114,6 +124,7 @@ export class TurboStream extends EventEmitter {
 	 * @param {String} content - The HTML content of the element.
 	 * @emits element
 	 * @returns {TurboStream} The instance for chaining.
+	 * @since 1.0.0
 	 */
 	addElement(attributesOrElement, content) {
 		let el;
@@ -140,6 +151,7 @@ export class TurboStream extends EventEmitter {
 	 * 
 	 * @emits clear
 	 * @returns {TurboStream} The instance for chaining.
+	 * @since 1.0.0
 	 */
 	clear() {
 		this.elements = [];
@@ -154,6 +166,7 @@ export class TurboStream extends EventEmitter {
 	 * 
 	 * @returns {String|null} The rendered Turbo Stream HTML fragment or null if there were no buffered elements.
 	 * @emits render
+	 * @since 1.0.0
 	 */
 	render() {
 		const arr = this.renderElements();
@@ -172,6 +185,7 @@ export class TurboStream extends EventEmitter {
 	 * If there are buffered elements, renders them and returns an array with the HTML fragments.
 	 * 
 	 * @returns {Array|null} The rendered Turbo Stream HTML fragments as array or null if there were no buffered elements.
+	 * @since 1.0.0
 	 */
 	renderElements() {
 		if (this.elements.length > 0) {
@@ -188,6 +202,7 @@ export class TurboStream extends EventEmitter {
 	 * @returns {String|null} The rendered Turbo Stream HTML fragment or null if there were no buffered elements.
 	 * @emits {render}
 	 * @emits {clear}
+	 * @since 1.0.0
 	 */
 	flush() {
 		const html = this.render();
@@ -204,6 +219,7 @@ export class TurboStream extends EventEmitter {
 	 * @param {String} target - The target ID.
 	 * @param {String} content - The HTML content of the element. 
 	 * @returns {TurboStream} The instance for chaining.
+	 * @since 1.0.0
 	 */
 	custom(action, target, content) {
 		return this.addElement({ action, target }, content);
@@ -217,6 +233,7 @@ export class TurboStream extends EventEmitter {
 	 * @param {String} targets - The query string targeting multiple DOM elements.
 	 * @param {String} content - The HTML content of the element. 
 	 * @returns {TurboStream} The instance for chaining.
+	 * @since 1.0.0
 	 */
 	customAll(action, targets, content) {
 		return this.addElement({ action, targets }, content);
@@ -224,7 +241,14 @@ export class TurboStream extends EventEmitter {
 
 
 	/**
+	 * Creates a readable stream.
 	 * 
+	 * @param {Object<String, String>} opts - The options for stream creation.
+	 * @param {Boolean} opts.continuous - If true, a TurboReadable instance is returned. 
+	 *  If false, a readable stream created from the buffered items is returned.
+	 * @param {Object<String, String>} streamOptions - The options for the readable stream itself.
+	 * @returns {stream.Readable|TurboReadable} Either a readable stream or a TurboReadable instance.
+	 * @since 1.0.0
 	 */
 	createReadableStream(opts, streamOptions = {}) {
 		opts = Object.assign({}, { continuous: true }, opts);
@@ -239,11 +263,34 @@ export class TurboStream extends EventEmitter {
 			return Readable.from(this.length > 0 ? this.render().split('\n') : [], streamOptions);
 		}
 	}
+
+
+	/**
+	 * Adds a Turbo Stream Element with the action 'refresh' to the message.
+	 * 
+	 * @param {String|Object<String, String>} requestIdOrAttributes - Either the request ID as string or all attributes as an object.
+	 * @returns {TurboStream} The instance for chaining.
+	 * @since 1.1.0
+	 */
+	refresh(requestIdOrAttributes) {
+		if (typeof requestIdOrAttributes === 'string') {
+			return this.addElement({ action: 'refresh', 'request-id': requestIdOrAttributes });	
+		}
+		else {
+			return this.addElement(Object.assign({ action: 'refresh' }, requestIdOrAttributes));	
+		}
+	}
+
 }
 
 
 // Add convenience functions for all supported actions.
 TurboStream.ACTIONS.forEach(action => {
+	// This action needs special treatment.
+	if (action === 'refresh') {
+		return;
+	}
+
 	TurboStream.prototype[action] = function(targetOrAttributes, content) {
 		if (typeof targetOrAttributes === 'string') {
 			return this.addElement({ action: action, target: targetOrAttributes }, content);	
@@ -255,96 +302,5 @@ TurboStream.ACTIONS.forEach(action => {
 
 	TurboStream.prototype[`${action}All`] = function(targets, content) {
 		return this.addElement({ action: action, targets }, content);	
-	};
+	};	
 });
-
-// Dynamic functions:
-
-/**
- * @name #append
- * @function
- * @description Adds a Turbo Stream element with the action 'append' to the message.
- * @param {String|Object<String, String>} targetOrAttributes - Either the target ID as string or all attributes as object.
- * @param {String} content - The HTML content of the element.
- */
-
-/**
- * @name #prepend
- * @function
- * @description Adds a Turbo Stream element with the action 'prepend' to the message.
- * @param {(String|Object<String, String>)} targetOrAttributes - Either the target ID as string or all attributes as object.
- * @param {String} content - The HTML content of the element.
- */
-
-/**
- * @name #replace
- * @function
- * @description Adds a Turbo Stream element with the action 'replace' to the message.
- * @param {(String|Object<String, String>)} targetOrAttributes - Either the target ID as string or all attributes as object.
- * @param {String} content - The HTML content of the element.
- */
-
-/**
- * @name #update
- * @function
- * @description Adds a Turbo Stream element with the action 'update' to the message.
- * @param {String|Object<String, String>} targetOrAttributes - Either the target ID as string or all attributes as object.
- * @param {String} content - The HTML content of the element.
- */
-
-/**
- * @name #remove
- * @function
- * @description Adds a Turbo Stream element with the action 'remove' to the message.
- * @param {String|Object<String, String>} targetOrAttributes - Either the target ID as string or all attributes as object.
- * @param {String} content - The HTML content of the element.
- */
-
-/**
- * @name #before
- * @function
- * @description Adds a Turbo Stream element with the action 'before' to the message.
- * @param {String|Object<String, String>} targetOrAttributes - Either the target ID as string or all attributes as object.
- * @param {String} content - The HTML content of the element.
- */
-
-/**
- * @name after
- * @function
- * @description Adds a Turbo Stream element with the action 'after' to the message.
- * @param {String|Object<String, String>} targetOrAttributes - Either the target ID as string or all attributes as object.
- * @param {String} content - The HTML content of the element.
- */
-
-// Events:
-
-/**
- * Event element.
- * Gets fired when a Turbo Stream element has been added to a message.
- *
- * @event element
- * @param {TurboStreamElement} - The added element.
- */
-
-/**
- * Event render.
- * Gets fired when a Turbo Stream message has been rendered.
- *
- * @event render
- * @param {String} - The rendered HTML fragment.
- */
-
-/**
- * Event config.
- * Gets fired when the config has been updated.
- *
- * @event config
- * @param {Object} - The updated config object.
- */
-
-/**
- * Event clear.
- * Gets fired when the buffer is cleared.
- *
- * @event clear
- */

package/lib/ws/ws-turbo-stream.js

@@ -6,6 +6,7 @@ import { TurboStream } from '#core';
  * This class represents a Turbo Stream message with added functionality for WebSockets.
  * 
  * @extends {TurboStream}
+ * @since 1.0.0
  */
 export class WsTurboStream extends TurboStream {
 	
@@ -13,6 +14,7 @@ export class WsTurboStream extends TurboStream {
 	 * The WebSocket instance to send to.
 	 * 
 	 * @type {WebSocket}
+	 * @since 1.0.0
 	 */
 	ws;
 
@@ -23,6 +25,7 @@ export class WsTurboStream extends TurboStream {
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/readyState
 	 * @type {Number}
 	 * @static
+	 * @since 1.0.0
 	 */
 	static OPEN = 1;
 
@@ -34,6 +37,7 @@ export class WsTurboStream extends TurboStream {
 	 * @static
 	 * @param {WebSocket} ws - The WebSocket instance to send to.
 	 * @returns {WsTurboStream} - A new WsTurboStream instance.
+	 * @since 1.0.0
 	 */
 	static use(ws) {
 		return new this(ws, { buffer: false });
@@ -46,6 +50,7 @@ export class WsTurboStream extends TurboStream {
 	 * @param {WebSocket} ws - The WebSocket to send to.
 	 * @param {Object} [config] - The config to override.
 	 * @listens config
+	 * @since 1.0.0
 	 */
 	constructor(ws, config) {
 		super();
@@ -70,6 +75,7 @@ export class WsTurboStream extends TurboStream {
 	 * @param {Object} config - The changed config object.
 	 * @listens element
 	 * @listens render
+	 * @since 1.0.0
 	 */
 	handleConfig(config) {
 		if (config.buffer === true) {
@@ -94,6 +100,7 @@ export class WsTurboStream extends TurboStream {
 	 * Sends the rendered HTML fragment to the WebSocket.
 	 * 
 	 * @param {String} html - The rendered HTML fragment.
+	 * @since 1.0.0
 	 */
 	handleRender(html) {
 		this.ws.send(html);	
@@ -104,6 +111,7 @@ export class WsTurboStream extends TurboStream {
 	 * Sends the Turbo Stream element to the WebSocket.
 	 * 
 	 * @param {TurboStreamElement} element - The Turbo Stream element to send.
+	 * @since 1.0.0
 	 */
 	handleElement(element) {
 		this.ws.send(element.render());	

package/package.json

@@ -1,8 +1,23 @@
 {
 	"name": "node-turbo",
-	"version": "1.0.1",
+	"version": "1.1.0",
 	"description": "A library for Node.js to assist with the server side of 37signals' Hotwire Turbo framework. It provides classes and functions for Web servers and also convenience functions for the frameworks Koa and Express as well as for WebSocket and SSE.",
-	"keywords": ["node", "turbo", "node-turbo", "nodejs", "hotwire", "hotwired", "server", "http", "koa", "express", "sse", "websocket", "ws"],
+	"keywords": [
+		"node",
+		"turbo",
+		"node-turbo",
+		"nodejs",
+		"hotwire",
+		"hotwired",
+		"server",
+		"http",
+		"http2",
+		"koa",
+		"express",
+		"sse",
+		"websocket",
+		"ws"
+	],
 	"homepage": "https://github.com/VividVisions/node-turbo",
 	"bugs": "https://github.com/VividVisions/node-turbo/issues",
 	"repository": {
@@ -39,37 +54,37 @@
 		"test:package": "NODE_ENV=testing mocha --ignore \"./test/unit/**\" --ignore \"./test/integration/**\"",
 		"test:all": "NODE_ENV=testing mocha",
 		"test:coverage": "c8 -c './.c8rc.json' npm test",
-		"pretest:coverage": "rm -rd ./coverage",
 		"docs": "esdoc -c ./.esdoc.json",
 		"postdocs": "cp -f ./docs/internal/API.md ./docs"
 	},
 	"dependencies": {
+		"debug": "^4.3.4",
 		"is-plain-object": "^5.0.0",
-		"negotiator": "^0.6.3",
-		"debug": "^4.3.4"
+		"negotiator": "^0.6.3"
 	},
 	"devDependencies": {
 		"@enterthenamehere/esdoc": "^2.6.0-dev.1",
 		"@enterthenamehere/esdoc-external-nodejs-plugin": "^2.6.0-dev.1",
 		"@enterthenamehere/esdoc-importpath-plugin": "^2.6.0-dev.1",
 		"@enterthenamehere/esdoc-standard-plugin": "^2.6.0-dev.2",
+		"@hotwired/turbo": "^8.0.4",
+		"@playwright/test": "^1.42.1",
 		"@vividvisions/esdoc-api-doc-markdown-plugin": "file:../esdoc-api-doc-markdown-plugin",
-		"@hotwired/turbo": "^8.0.0-beta.1",
-		"c8": "^8.0.1",
-		"chai": "^4.3.10",
+		"c8": "^9.1.0",
+		"chai": "^4.1.1",
 		"chai-eventemitter2": "^0.2.1",
 		"chai-spies": "^1.1.0",
 		"colorette": "^2.0.20",
 		"eventsource": "^2.0.2",
-		"express": "^4.18.2",
+		"express": "^4.18.3",
 		"git-repo-info": "^2.1.1",
-		"koa": "^2.14.2",
-		"koa-route": "^3.2.0",
+		"koa": "^2.15.0",
+		"koa-route": "^4.0.1",
 		"koa-static": "^5.0.0",
-		"mocha": "^10.2.0",
-		"node-mocks-http": "^1.14.0",
+		"mocha": "^10.3.0",
+		"node-mocks-http": "^1.14.1",
 		"nunjucks": "^3.2.4",
-		"supertest": "^6.3.3",
-		"ws": "^8.15.1"
+		"supertest": "^6.3.4",
+		"ws": "^8.16.0"
 	}
 }

package/test/unit/core/turbo-element.test.js

@@ -2,6 +2,11 @@
 import { expect } from 'chai';
 import { TurboElement } from '#core';
 
+
+class NonThrowingTurboElement extends TurboElement {
+	validate() {}
+}
+
 describe('TurboElement', function() {
 	
 	it('Constructor correctly assigns properties (and throws Error)', function() {
@@ -12,4 +17,28 @@ describe('TurboElement', function() {
 		}).to.throw();
 	});
 	
+
+	describe('renderAttributesAsHtml()', function() {
+
+		it('correctly renders attributes', function() {
+			const te = new NonThrowingTurboElement({ 
+					foo: 'bar',
+					two: 2
+				});
+
+			expect(te.renderAttributesAsHtml()).to.equal('foo="bar" two="2"');
+		});
+
+
+		it('correctly renders booelan attributes', function() {
+			const te = new NonThrowingTurboElement({ 
+					foo: 'bar',
+					bool: null
+				});
+
+			expect(te.renderAttributesAsHtml()).to.equal('foo="bar" bool');
+		});	
+
+	});
+
 });

package/test/unit/core/turbo-stream-element.test.js

@@ -73,4 +73,11 @@ describe('TurboStreamElement', function() {
 
 	});
 
+	
+	it(`No error is thrown when action is "refresh" with missing attribute "target" or "targets"`, function() {		
+		expect(function() {
+			const tse = new TurboStreamElement({ action: 'refresh' });	
+		}).to.not.throw();
+	});	
+
 });

package/test/unit/core/turbo-stream.test.js

@@ -252,6 +252,15 @@ describe('TurboStream', function() {
 
 
 		TurboStream.ACTIONS.forEach(action => {
+			if (action === 'refresh') {
+				it ('refresh() correctly omits <template> and content', function() {
+					const ts = new TurboStream({ action: 'refresh' });
+					
+					expect(ts.render()).to.equal('<turbo-stream action="refresh"></turbo-stream>');
+				});
+				return;
+			}
+
 			it (`${action}() adds TurboElement with action \'${action}\'`, function() {
 				const ts = new TurboStream();
 				ts[action].call(ts, { target: 't' }, 'c');
@@ -278,6 +287,28 @@ describe('TurboStream', function() {
 			});	
 		});
 
+
+		it ('refresh() adds TurboElement with action \'refresh\'', function() {
+			const ts = new TurboStream();
+			ts.refresh();
+
+			expect(ts.elements[0] instanceof TurboElement).to.be.true;
+			expect(ts.elements[0].attributes.action).to.equal('refresh');
+		});
+
+		it ('refresh(<string>) adds attribute \'request-id\'', function() {
+			const ts = new TurboStream();
+			ts.refresh('id');
+			expect(ts.elements[0].attributes).to.have.property('request-id');
+			expect(ts.elements[0].attributes['request-id']).to.equal('id');
+		});
+
+		it ('refresh(<object>) adds attributes', function() {
+			const ts = new TurboStream();
+			ts.refresh({ foo: 'bar' });
+			expect(ts.elements[0].attributes).to.have.property('foo');
+			expect(ts.elements[0].attributes.foo).to.equal('bar');
+		});
 	});