Clarify difference between raw and parsed page.

Author: RubenVerborgh

lib/triple-pattern-fragments/FragmentsClient.js

@@ -121,26 +121,25 @@ Fragment.prototype._read = function (count, done) {
 // Loads the Triple Pattern Fragment located at the given URL
 Fragment.prototype.loadFromUrl = function (pageUrl) {
   // Fetch a page of the fragment
-  var fragment = this, fragmentsClient = this._fragmentsClient, page,
+  var fragment = this, fragmentsClient = this._fragmentsClient, rawPage,
       headers = { 'user-agent': 'Triple Pattern Fragments Client' };
   if (fragmentsClient._startFragmentUrl) headers.referer = fragmentsClient._startFragmentUrl;
-  page = fragmentsClient._httpClient.get(pageUrl, headers);
-  page.on('error', function (error) { fragment.emit('error', error); });
+  rawPage = fragmentsClient._httpClient.get(pageUrl, headers);
+  rawPage.on('error', function (error) { fragment.emit('error', error); });
 
-  page.getProperty('statusCode', function (statusCode) {
-    // Don't parse the page if its retrieval was unsuccessful
+  // Parse the raw page when the response arrives, extracting data, metadata, and controls
+  rawPage.getProperty('statusCode', function (statusCode) {
     if (statusCode !== 200) {
-      page.emit('error', new Error('Could not retrieve ' + pageUrl + ' (' + statusCode + ')'));
+      rawPage.emit('error', new Error('Could not retrieve ' + pageUrl + ' (' + statusCode + ')'));
       return fragment.close();
     }
 
-    // Obtain the page's data, metadata, and controls
-    page.getProperty('contentType', function (contentType) {
-      // Parse the page using the appropriate parser for the content type
+    // Parse the raw page using the appropriate parser for the content type
+    rawPage.getProperty('contentType', function (contentType) {
       var Parser = _.find(parserTypes, function (P) { return P.supportsContentType(contentType); });
       if (!Parser)
         return fragment.emit('error', new Error('No parser for ' + contentType + ' at ' + pageUrl));
-      var parsedPage = fragment._page = new Parser(page, pageUrl);
+      var parsedPage = fragment._page = new Parser(rawPage, pageUrl);
       parsedPage.on('readable', function () { fragment.readable = true; });
 
       // Extract the page's metadata and controls