Sid Gifari File Manager Pro v10.0.3

✏️ Editing: summarize.js Writable

/*global describe, expect, it */
'use strict';

var summarize = require('../../summarize');

describe('summarize', function() {
    it('should export handlers', function() {
        expect(summarize.handlers).toBeDefined();
        expect(typeof summarize.handlers).toBe('object');
    });

it('should export a newDoclet handler', function() {
        expect(summarize.handlers.newDoclet).toBeDefined();
        expect(typeof summarize.handlers.newDoclet).toBe('function');
    });

describe('newDoclet handler', function() {
        var handler = summarize.handlers.newDoclet;

it('should not blow up if the doclet is missing', function() {
            function noDoclet() {
                return handler({});
            }

expect(noDoclet).not.toThrow();
        });

it('should not change the summary if it is already defined', function() {
            var doclet = {
                summary: 'This is a summary.',
                description: 'Descriptions are good.'
            };
            handler({ doclet: doclet });

expect(doclet.summary).not.toBe(doclet.description);
        });

it('should not do anything if the description is missing', function() {
            var doclet = {};
            handler({ doclet: doclet });

expect(doclet.summary).not.toBeDefined();
        });

it('should use the first sentence as the summary', function() {
            var doclet = {
                description: 'This sentence is the summary. This sentence is not.'
            };
            handler({ doclet: doclet });

expect(doclet.summary).toBe('This sentence is the summary.');
        });

it('should not add an extra period if there is only one sentence in the description',
            function() {
            var doclet = {
                description: 'This description has only one sentence.'
            };
            handler({ doclet: doclet });

expect(doclet.summary).toBe('This description has only one sentence.');
        });

it('should use the entire description, plus a period, as the summary if the description ' +
            'does not contain a period', function() {
            var doclet = {
                description: 'This is a description'
            };
            handler({ doclet: doclet });

expect(doclet.summary).toBe('This is a description.');
        });

it('should use the entire description as the summary if the description contains only ' +
            'one sentence', function() {
            var doclet = {
                description: 'This is a description.'
            };
            handler({ doclet: doclet });

expect(doclet.description).toBe('This is a description.');
        });

it('should work when an HTML tag immediately follows the first sentence', function() {
 var doclet = {
 description: 'This sentence is the summary.This sentence is small.'
 };
 handler({ doclet: doclet });

expect(doclet.summary).toBe('This sentence is the summary.');
        });

it('should generate valid HTML if a tag is opened, but not closed, in the summary',
 function() {
 var doclet = {
 description: 'This description has a tag. The tag straddles sentences.'
 };
 handler({ doclet: doclet });

expect(doclet.summary).toBe('This description has a tag.');
 });

it('should not include a tag in the summary', function() {
 var doclet = {
 description: 'This description contains HTML.And plenty of it!'
 };
 handler({ doclet: doclet });

expect(doclet.summary).toBe('This description contains HTML.');
        });
    });
});

📁 File Manager Pro

📁 File Manager Pro