chromium/third_party/google-closure-library/closure/goog/ui/textarea_test.js

/**
 * @license
 * Copyright The Closure Library Authors.
 * SPDX-License-Identifier: Apache-2.0
 */

goog.module('goog.ui.TextareaTest');
goog.setTestOnly();

const EventObserver = goog.require('goog.testing.events.EventObserver');
const ExpectedFailures = goog.require('goog.testing.ExpectedFailures');
const Textarea = goog.require('goog.ui.Textarea');
const TextareaRenderer = goog.require('goog.ui.TextareaRenderer');
const classlist = goog.require('goog.dom.classlist');
const dom = goog.require('goog.dom');
const events = goog.require('goog.events');
const product = goog.require('goog.userAgent.product');
const style = goog.require('goog.style');
const testSuite = goog.require('goog.testing.testSuite');
const userAgent = goog.require('goog.userAgent');

let sandbox;
let textarea;
let demoTextareaElement;
let expectedFailures;

/** @return {boolean} Whether we're on Mac Safari 3.x. */
function isMacSafari3() {
  return false;
}

/** @return {boolean} Whether we're on Linux Firefox 3.6.3. */
function isLinuxFirefox() {
  return product.FIREFOX && userAgent.LINUX;
}

testSuite({
  setUp() {
    sandbox = dom.getElement('sandbox');
    /** @suppress {checkTypes} suppression added to enable type checking */
    textarea = new Textarea();
    demoTextareaElement = dom.getElement('demo-textarea');
    expectedFailures = new ExpectedFailures();
  },

  tearDown() {
    expectedFailures.handleTearDown();
    textarea.dispose();
    dom.removeChildren(sandbox);
  },

  testConstructor() {
    assertNotNull('Textarea must not be null', textarea);
    assertEquals(
        'Renderer must default to expected value',
        TextareaRenderer.getInstance(), textarea.getRenderer());

    const fakeDomHelper = {
      'getDocument': function() {
        return true;
      }
    };
    /** @suppress {checkTypes} suppression added to enable type checking */
    const testTextarea =
        new Textarea('Hello', TextareaRenderer.getInstance(), fakeDomHelper);
    assertEquals(
        'Content must have expected content', 'Hello',
        testTextarea.getContent());
    assertEquals(
        'Renderer must have expected value', TextareaRenderer.getInstance(),
        testTextarea.getRenderer());
    assertEquals(
        'DOM helper must have expected value', fakeDomHelper,
        testTextarea.getDomHelper());
    testTextarea.dispose();
  },

  /**
     @suppress {visibility,strictMissingProperties} suppression added to enable
     type checking
   */
  testConstructorWithDecorator() {
    /** @suppress {checkTypes} suppression added to enable type checking */
    const decoratedTextarea = new Textarea();
    decoratedTextarea.decorate(demoTextareaElement);
    assertEquals(
        'Textarea should have current content after decoration', 'Foo',
        decoratedTextarea.getContent());
    /** @suppress {visibility} suppression added to enable type checking */
    const initialHeight = decoratedTextarea.getHeight_();
    /**
     * @suppress {strictMissingProperties} suppression added to enable type
     * checking
     */
    const initialOffsetHeight = decoratedTextarea.getElement().offsetHeight;
    // focus() will trigger the grow/shrink flow.
    decoratedTextarea.getElement().focus();
    assertEquals(
        'Height should not have changed without content change', initialHeight,
        decoratedTextarea.getHeight_());
    assertEquals(
        'offsetHeight should not have changed without content ' +
            'change',
        initialOffsetHeight, decoratedTextarea.getElement().offsetHeight);
    decoratedTextarea.dispose();
  },

  testGetSetContent() {
    textarea.render(sandbox);
    assertEquals(
        'Textarea\'s content must default to an empty string', '',
        textarea.getContent());
    textarea.setContent(17);
    assertEquals(
        'Textarea element must have expected content', '17',
        textarea.getElement().value);
    textarea.setContent('foo');
    assertEquals(
        'Textarea element must have updated content', 'foo',
        textarea.getElement().value);
  },

  testGetSetValue() {
    textarea.render(sandbox);
    assertEquals(
        'Textarea\'s content must default to an empty string', '',
        textarea.getValue());
    textarea.setValue(17);
    assertEquals(
        'Textarea element must have expected content', '17',
        textarea.getValue());
    textarea.setValue('17');
    assertEquals(
        'Textarea element must have expected content', '17',
        textarea.getValue());
  },

  testBasicTextareaBehavior() {
    const observer = new EventObserver();
    events.listen(textarea, Textarea.EventType.RESIZE, observer);
    textarea.render(sandbox);
    const el = textarea.getElement();
    /** @suppress {visibility} suppression added to enable type checking */
    const heightBefore = textarea.getHeight_();
    assertTrue(
        'One resize event should be fired during render',
        observer.getEvents().length == 1);
    textarea.setContent(
        'Lorem ipsum dolor sit amet, consectetuer ' +
        'elit. Aenean sollicitudin ultrices urna. Proin vehicula mauris ac ' +
        'est. Ut scelerisque, risus ut facilisis dictum, est massa lacinia ' +
        'lorem, in fermentum purus ligula quis nunc.');
    /** @suppress {visibility} suppression added to enable type checking */
    let heightAfter = textarea.getHeight_();
    assertTrue(
        'With this much content, height should have grown.',
        heightAfter > heightBefore);
    assertTrue(
        'With a height change, a resize event should have fired.',
        observer.getEvents().length == 2);
    textarea.setContent('');
    /** @suppress {visibility} suppression added to enable type checking */
    heightAfter = textarea.getHeight_();
    assertTrue(
        'Textarea should shrink with no content.', heightAfter <= heightBefore);
    assertTrue(
        'With a height change, a resize event should have fired.',
        observer.getEvents().length == 3);
    events.unlisten(textarea, Textarea.EventType.RESIZE, observer);
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testMinHeight() {
    textarea.render(sandbox);
    textarea.setMinHeight(50);
    assertEquals(
        'offsetHeight should be 50 initially', 50,
        textarea.getElement().offsetHeight);
    textarea.setContent(
        'Lorem ipsum dolor sit amet, consectetuer  ' +
        'elit. Aenean sollicitudin ultrices urna. Proin vehicula mauris ac ' +
        'est. Ut scelerisque, risus ut facilisis dictum, est massa lacinia ' +
        'lorem, in fermentum purus ligula quis nunc.');
    assertTrue('getHeight_() should be > 50', textarea.getHeight_() > 50);

    textarea.setContent('');
    assertEquals(
        'With no content, offsetHeight should go back to 50, ' +
            'the minHeight.',
        50, textarea.getElement().offsetHeight);

    textarea.setMinHeight(0);
    assertTrue(
        'After setting minHeight to 0, offsetHeight should ' +
            'now be < 50, but it is ' + textarea.getElement().offsetHeight,
        textarea.getElement().offsetHeight < 50);
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testMouseUpListener() {
    textarea.render(sandbox);
    textarea.setMinHeight(100);
    textarea.setMaxHeight(200);
    textarea.mouseUpListener_({});
    assertEquals(
        'After a mouseup which is not a resize, minHeight should ' +
            'still be 100',
        100, textarea.minHeight_);

    // We need to test how CSS drop shadows effect this too.
    classlist.add(textarea.getElement(), 'drop-shadowed');
    textarea.mouseUpListener_({});
    assertEquals(
        'After a mouseup which is not a resize, minHeight should ' +
            'still be 100 even with a shadow',
        100, textarea.minHeight_);
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testMaxHeight() {
    textarea.render(sandbox);
    textarea.setMaxHeight(50);
    assertTrue(
        'Initial offsetHeight should be less than 50',
        textarea.getElement().offsetHeight < 50);
    const newContent = 'Lorem ipsum dolor sit amet, consectetuer adipiscing ' +
        'elit. Aenean sollicitudin ultrices urna. Proin vehicula mauris ac ' +
        'est. Ut scelerisque, risus ut facilisis dictum, est massa lacinia ' +
        'lorem, in fermentum purus ligula quis nunc.';
    textarea.setContent(newContent);

    assertTrue(
        'With lots of content, getHeight_() should be > 50',
        textarea.getHeight_() > 50);
    assertEquals(
        'Even with lots of content, offsetHeight should be 50 ' +
            'with maxHeight set',
        50, textarea.getElement().offsetHeight);
    textarea.setMaxHeight(0);
    assertTrue(
        'After setting maxHeight to 0, offsetHeight should now ' +
            'be > 50',
        textarea.getElement().offsetHeight > 50);
  },

  testMaxHeight_canShrink() {
    textarea.render(sandbox);
    textarea.setMaxHeight(50);
    assertTrue(
        'Initial offsetHeight should be less than 50',
        textarea.getElement().offsetHeight < 50);
    const newContent = 'Lorem ipsum dolor sit amet, consectetuer adipiscing ' +
        'elit. Aenean sollicitudin ultrices urna. Proin vehicula mauris ac ' +
        'est. Ut scelerisque, risus ut facilisis dictum, est massa lacinia ' +
        'lorem, in fermentum purus ligula quis nunc.';
    textarea.setContent(newContent);

    assertEquals(
        'Even with lots of content, offsetHeight should be 50 ' +
            'with maxHeight set',
        50, textarea.getElement().offsetHeight);
    textarea.setContent('');
    assertTrue(
        'With no content, offsetHeight should be back to < 50',
        textarea.getElement().offsetHeight < 50);
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testSetPlaceholder() {
    textarea.setPlaceholder('Some default text here.');
    textarea.setPlaceholder('new default text...');
    textarea.render(sandbox);
    if (textarea.supportsNativePlaceholder_()) {
      assertEquals('new default text...', textarea.getElement().placeholder);
    }
    assertEquals('', textarea.getValue());
    textarea.setValue('some value');
    assertEquals('some value', textarea.getValue());
    // ensure setting a new placeholder doesn't replace the value.
    textarea.setPlaceholder('some new placeholder');
    assertEquals('some value', textarea.getValue());
  },

  /**
     @suppress {visibility,strictMissingProperties} suppression added to enable
     type checking
   */
  testSetPlaceholderForInitialContent() {
    const testTextarea = new Textarea('initial content');
    testTextarea.render(sandbox);
    assertEquals('initial content', testTextarea.getValue());
    testTextarea.setPlaceholder('new default text...');
    assertEquals('initial content', testTextarea.getValue());
    testTextarea.setValue('new content');
    assertEquals('new content', testTextarea.getValue());
    testTextarea.setValue('');
    assertEquals('', testTextarea.getValue());
    if (!testTextarea.supportsNativePlaceholder_()) {
      // Pretend we leave the textarea. When that happens, the
      // placeholder text should appear.
      assertEquals('', testTextarea.getElement().value);
      testTextarea.blur_();
      assertEquals('new default text...', testTextarea.getElement().value);
    }
  },

  testMinAndMaxHeight() {
    textarea.render(sandbox);
    textarea.setMinHeight(50);
    textarea.setMaxHeight(150);
    assertEquals(
        'offsetHeight should be 50 initially', 50,
        textarea.getElement().offsetHeight);

    textarea.setContent(
        'Lorem ipsum dolor sit amet, consectetuer  ' +
        'elit. Aenean sollicitudin ultrices urna. Proin vehicula mauris ac ' +
        'est. Ut scelerisque, risus ut facilisis dictum, est massa lacinia ' +
        'lorem, in fermentum purus ligula quis nunc.');

    /** @suppress {visibility} suppression added to enable type checking */
    const height = textarea.getHeight_();
    // For some reason Mac Safari 3 has 136 and Linux FF has 146 here.
    expectedFailures.expectFailureFor(isMacSafari3() || isLinuxFirefox());
    try {
      assertTrue(
          'With lots of content, getHeight_() should be > 150 ' +
              '(it is ' + height + ')',
          height > 150);
      assertEquals(
          'Even with lots of content, offsetHeight should be 150 ' +
              'with maxHeight set',
          150, textarea.getElement().offsetHeight);

      textarea.setMaxHeight(0);
      assertTrue(
          'After setting maxHeight to 0, offsetHeight should now ' +
              'be > 150 (it is ' + textarea.getElement().offsetHeight + ')',
          textarea.getElement().offsetHeight > 150);

      textarea.setContent('');
      textarea.setMinHeight(0);
      assertTrue(
          'After setting minHeight to 0, with no contents, ' +
              'offsetHeight should now be < 50',
          textarea.getElement().offsetHeight < 50);
    } catch (e) {
      expectedFailures.handleException(e);
    }
  },

  testSetValueWhenInvisible() {
    textarea.render(sandbox);
    const content = 'Lorem ipsum dolor sit amet, consectetuer  ' +
        'elit. Aenean sollicitudin ultrices urna. Proin vehicula mauris ac ' +
        'est. Ut scelerisque, risus ut facilisis dictum, est massa lacinia ' +
        'lorem, in fermentum purus ligula quis nunc.';
    textarea.setValue(content);
    /** @suppress {visibility} suppression added to enable type checking */
    let height = textarea.getHeight_();
    let elementHeight = style.getStyle(textarea.getElement(), 'height');
    assertEquals(`${height}px`, elementHeight);

    // Hide the element, height_ should be invalidate when setValue().
    style.setElementShown(textarea.getElement(), false);
    textarea.setValue(content);

    // Show the element again.
    style.setElementShown(textarea.getElement(), true);
    textarea.setValue(content);
    /** @suppress {visibility} suppression added to enable type checking */
    height = textarea.getHeight_();
    elementHeight = style.getStyle(textarea.getElement(), 'height');
    assertEquals(`${height}px`, elementHeight);
  },

  testSetAriaLabel() {
    assertNull(
        'Textarea must not have aria label by default',
        textarea.getAriaLabel());
    textarea.setAriaLabel('My textarea');
    textarea.render(sandbox);
    const element = textarea.getElementStrict();
    assertNotNull('Element must not be null', element);
    assertEquals(
        'Item element must have expected aria-label', 'My textarea',
        element.getAttribute('aria-label'));
    textarea.setAriaLabel('My new textarea');
    assertEquals(
        'Item element must have updated aria-label', 'My new textarea',
        element.getAttribute('aria-label'));
  },
});