/* global moment */ const utils = require( './utils.js' ); /** * A thread item, either a heading or a comment * * @class ThreadItem * @constructor * @param {string} type `heading` or `comment` * @param {number} level Indentation level * @param {Object} range Object describing the extent of the comment, including the * signature and timestamp. It has the same properties as a Range object: `startContainer`, * `startOffset`, `endContainer`, `endOffset` (we don't use a real Range because they change * magically when the DOM structure changes). */ function ThreadItem( type, level, range ) { this.type = type; this.level = level; this.range = range; /** * @member {string} Name for this comment, intended to be used to * find this comment in other revisions of the same page */ this.name = null; /** * @member {string} Unique ID (within the page) for this comment */ this.id = null; /** * @member {ThreadItem[]} Replies to this thread item */ this.replies = []; /** * @member {string[]} Warnings */ this.warnings = []; this.rootNode = null; this.authors = null; this.commentCount = null; this.oldestReply = null; this.latestReply = null; } OO.initClass( ThreadItem ); /** * Create a new ThreadItem from a JSON serialization * * @param {string|Object} json JSON serialization or hash object * @param {HTMLElement} rootNode * @return {ThreadItem} * @throws {Error} Unknown ThreadItem type */ ThreadItem.static.newFromJSON = function ( json, rootNode ) { // The page can be served from the HTTP cache (Varnish), and the JSON may be generated // by an older version of our PHP code. Code below must be able to handle that. // See ThreadItem::jsonSerialize() in PHP. const hash = typeof json === 'string' ? JSON.parse( json ) : json; let item; switch ( hash.type ) { case 'comment': { // Late require to avoid circular dependency const CommentItem = require( './CommentItem.js' ); item = new CommentItem( hash.level, hash.range, hash.signatureRanges, hash.timestampRanges, moment.utc( hash.timestamp, [ // See CommentItem#getTimestampString for notes about the two formats. 'YYYYMMDDHHmmss', moment.ISO_8601 ], true ), hash.author, hash.displayName ); break; } case 'heading': { const HeadingItem = require( './HeadingItem.js' ); // Cached HTML may still have the placeholder heading constant in it. // This code can be removed a few weeks after being deployed. if ( hash.headingLevel === 99 ) { hash.headingLevel = null; } item = new HeadingItem( hash.range, hash.headingLevel ); break; } default: throw new Error( 'Unknown ThreadItem type ' + hash.name ); } item.name = hash.name; item.id = hash.id; item.rootNode = rootNode; const idEscaped = $.escapeSelector( item.id ); const startMarker = document.getElementById( item.id ); const endMarker = document.querySelector( '[data-mw-comment-end="' + idEscaped + '"]' ); item.range = { // Start range after startMarker, because it produces funny results from getBoundingClientRect startContainer: startMarker.parentNode, startOffset: utils.childIndexOf( startMarker ) + 1, // End range inside endMarker, because modifier crashes if endContainer is a
/