/* global moment */ var 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 {string|null} Unique ID (within the page) for this comment, according to an older algorithm */ this.legacyId = null; /** * @member {ThreadItem[]} Replies to this thread item */ this.replies = []; /** * @member {string[]} Warnings */ this.warnings = []; this.rootNode = null; } OO.initClass( ThreadItem ); /** * Create a new ThreadItem from a JSON serialization * * @param {string|Object} json JSON serialization or hash object * @return {ThreadItem} * @throws {Error} Unknown ThreadItem type */ ThreadItem.static.newFromJSON = function ( json ) { // 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. var hash = typeof json === 'string' ? JSON.parse( json ) : json; var item; switch ( hash.type ) { case 'comment': // Late require to avoid circular dependency var CommentItem = require( './CommentItem.js' ); item = new CommentItem( hash.level, hash.range, hash.signatureRanges, moment( hash.timestamp ), hash.author ); break; case 'heading': var HeadingItem = require( './HeadingItem.js' ); item = new HeadingItem( hash.range, hash.headingLevel, hash.placeholderHeading ); break; default: throw new Error( 'Unknown ThreadItem type ' + hash.name ); } item.name = hash.name; item.id = hash.id; var idEscaped = $.escapeSelector( item.id ); var startMarker = document.getElementById( item.id ); var 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

/

/
  • node endContainer: endMarker, endOffset: 0 }; return item; }; /** * Get the list of authors in the comment tree below this thread item. * * Usually called on a HeadingItem to find all authors in a thread. * * @return {string[]} Author usernames */ ThreadItem.prototype.getAuthorsBelow = function () { var authors = {}; function getAuthorSet( comment ) { authors[ comment.author ] = true; // Get the set of authors in the same format from each reply comment.replies.forEach( getAuthorSet ); } this.replies.forEach( getAuthorSet ); return Object.keys( authors ).sort(); }; /** * Get the list of thread items in the comment tree below this thread item. * * @return {ThreadItem[]} Thread items */ ThreadItem.prototype.getThreadItemsBelow = function () { var threadItems = []; function getReplies( comment ) { threadItems.push( comment ); comment.replies.forEach( getReplies ); } this.replies.forEach( getReplies ); return threadItems; }; /** * Return a native Range object corresponding to the item's range. * * @return {Range} */ ThreadItem.prototype.getNativeRange = function () { var doc = this.range.startContainer.ownerDocument; var nativeRange = doc.createRange(); nativeRange.setStart( this.range.startContainer, this.range.startOffset ); nativeRange.setEnd( this.range.endContainer, this.range.endOffset ); return nativeRange; }; // TODO: Implement getHTML/getText if required module.exports = ThreadItem;