unpoly-rails 1.0.3 → 2.0.0.pre.rc2

data/spec_app/spec/javascripts/up/classes/params_spec.coffee

@@ -1,557 +0,0 @@
-u = up.util
-$ = jQuery
-
-describe 'up.Params', ->
-
-  encodeBrackets = (str) ->
-    str = str.replace(/\[/g, '%5B')
-    str = str.replace(/\]/g, '%5D')
-    str
-
-  beforeEach ->
-    jasmine.addMatchers
-      toEqualAfterEncodingBrackets: (util, customEqualityTesters) ->
-        compare: (actual, expected) ->
-          pass: actual == encodeBrackets(expected)
-
-  toObject = (value) -> new up.Params(value).toObject()
-  toQuery = (value) -> new up.Params(value).toQuery()
-  toArray = (value) -> new up.Params(value).toArray()
-  toFormData = (value) -> new up.Params(value).toFormData()
-
-  describe '#toQuery', ->
-
-    encodedSpace = '%20'
-
-    it 'returns the query section for the given object', ->
-      string = toQuery('foo-key': 'foo value', 'bar-key': 'bar value')
-      expect(string).toEqual("foo-key=foo#{encodedSpace}value&bar-key=bar#{encodedSpace}value")
-
-    it 'returns the query section for the given array with { name } and { value } keys', ->
-      string = toQuery([
-        { name: 'foo-key', value: 'foo value' },
-        { name: 'bar-key', value: 'bar value' }
-      ])
-      expect(string).toEqual("foo-key=foo#{encodedSpace}value&bar-key=bar#{encodedSpace}value")
-
-    it 'returns a given query string', ->
-      string = toQuery('foo=bar')
-      expect(string).toEqual('foo=bar')
-
-    it 'returns an empty string for an empty object', ->
-      string = toQuery({})
-      expect(string).toEqual('')
-
-    it 'returns an empty string for an empty string', ->
-      string = toQuery('')
-      expect(string).toEqual('')
-
-    it 'returns an empty string for undefined', ->
-      string = toQuery(undefined)
-      expect(string).toEqual('')
-
-    it 'URL-encodes characters in the key and value', ->
-      string = toQuery({ 'äpfel': 'bäume' })
-      expect(string).toEqual('%C3%A4pfel=b%C3%A4ume')
-
-    it "sets a blank value after the equal sign if a key's value is a blank string", ->
-      string = toQuery({'foo': ''})
-      expect(string).toEqual('foo=')
-
-    it 'omits non-primitive values (like Files) from the given params', ->
-      # I would like to construct a File, but IE11 does not support the constructor
-      blob = new Blob([])
-      string = toQuery(string: 'foo', blob: blob)
-      expect(string).toEqual('string=foo')
-
-    it "omits an equal sign if a key's value is null", ->
-      string = toQuery({'foo': null})
-      expect(string).toEqual('foo')
-
-    it 'URL-encodes plus characters', ->
-      string = toQuery({ 'my+key': 'my+value' })
-      expect(string).toEqual('my%2Bkey=my%2Bvalue')
-
-#    describeCapability 'canInspectFormData', ->
-#
-#      it 'converts a FormData object to a query string', ->
-#        fd = new FormData()
-#        fd.append('key1', 'value1')
-#        fd.append('key2', 'value2')
-#        string = toQuery(fd)
-#        expect(string).toEqual('key1=value1&key2=value2')
-
-  describe '#toArray', ->
-
-    it 'normalized null to an empty array', ->
-      array = toArray(null)
-      expect(array).toEqual([])
-
-    it 'normalized undefined to an empty array', ->
-      array = toArray(undefined)
-      expect(array).toEqual([])
-
-    it 'normalizes an object hash to an array of objects with { name } and { value } keys', ->
-      array = toArray(
-        'foo-key': 'foo-value'
-        'bar-key': 'bar-value'
-      )
-      expect(array).toEqual([
-        { name: 'foo-key', value: 'foo-value' },
-        { name: 'bar-key', value: 'bar-value' },
-      ])
-
-    it 'builds multiple entries if the given object has array values', ->
-      array = toArray(
-        foo: ['1', '2']
-        bar: '3'
-      )
-      expect(array).toEqual([
-        { name: 'foo', value: '1' },
-        { name: 'foo', value: '2' },
-        { name: 'bar', value: '3' },
-      ])
-
-    it 'returns a given array without modification', ->
-      array = toArray([
-        { name: 'foo-key', value: 'foo-value' },
-        { name: 'bar-key', value: 'bar-value' },
-      ])
-      expect(array).toEqual([
-        { name: 'foo-key', value: 'foo-value' },
-        { name: 'bar-key', value: 'bar-value' },
-      ])
-
-    it 'does not URL-encode special characters in keys or values', ->
-      array = toArray(
-        'äpfel': 'bäume'
-      )
-      expect(array).toEqual([
-        { name: 'äpfel', value: 'bäume' },
-      ])
-
-    it 'does not URL-encode spaces in keys or values', ->
-      array = toArray(
-        'my key': 'my value'
-      )
-      expect(array).toEqual([
-        { name: 'my key', value: 'my value' },
-      ])
-
-    it 'does not URL-encode ampersands in keys or values', ->
-      array = toArray(
-        'my&key': 'my&value'
-      )
-      expect(array).toEqual([
-        { name: 'my&key', value: 'my&value' },
-      ])
-
-    it 'does not URL-encode equal signs in keys or values', ->
-      array = toArray(
-        'my=key': 'my=value'
-      )
-      expect(array).toEqual([
-        { name: 'my=key', value: 'my=value' },
-      ])
-
-#    describeCapability 'canInspectFormData', ->
-#
-#      it 'converts a FormData object to an array', ->
-#        fd = new FormData()
-#        fd.append('key1', 'value1')
-#        fd.append('key2', 'value2')
-#        array = toArray(fd)
-#        expect(array).toEqual([
-#          { name: 'key1', value: 'value1' },
-#          { name: 'key2', value: 'value2' },
-#        ])
-
-
-  describe '#toFormData', ->
-
-    describeCapability 'canInspectFormData', ->
-
-      it 'converts undefined to an empty FormData object', ->
-        params = undefined
-        formData = toFormData(params)
-        expect(toArray(formData)).toEqual []
-
-      it 'converts null to an empty FormData object', ->
-        params = null
-        formData = toFormData(params)
-        expect(toArray(formData)).toEqual []
-
-      it 'converts an object to a FormData object', ->
-        params = {
-          key1: 'value1',
-          key2: 'value2'
-        }
-        formData = toFormData(params)
-        expect(toArray(formData)).toEqual [
-          { name: 'key1', value: 'value1' },
-          { name: 'key2', value: 'value2' },
-        ]
-
-      it 'returns a FormData with the same values', ->
-        input = new FormData()
-        input.append('foo', 'bar')
-
-        formData = toFormData(input)
-        expect(formData.get('foo')).toEqual('bar')
-
-      it 'converts a query string to a FormData object', ->
-        params = 'key1=value1&key2=value2'
-        formData = toFormData(params)
-        expect(toArray(formData)).toEqual [
-          { name: 'key1', value: 'value1' },
-          { name: 'key2', value: 'value2' },
-        ]
-
-      it 'unescapes percent-encoded characters from a query string', ->
-        params = 'my%20key=my%20value'
-        formData = toFormData(params)
-        expect(toArray(formData)).toEqual [
-          { name: 'my key', value: 'my value' }
-        ]
-
-
-  describe '#toObject', ->
-
-    it "parses a query string of flat key/value pairs", ->
-      expect(toObject("xfoo")).toEqual("xfoo": null)
-      expect(toObject("foo=")).toEqual("foo": "")
-      expect(toObject("foo=bar")).toEqual("foo": "bar")
-      expect(toObject("foo=\"bar\"")).toEqual("foo": "\"bar\"")
-
-      expect(toObject("foo=bar&foo=quux")).toEqual("foo": "quux")
-      expect(toObject("foo&foo=")).toEqual("foo": "")
-      expect(toObject("foo=1&bar=2")).toEqual("foo": "1", "bar": "2")
-      expect(toObject("&foo=1&&bar=2")).toEqual("foo": "1", "bar": "2")
-      expect(toObject("foo&bar=")).toEqual("foo": null, "bar": "")
-      expect(toObject("foo=bar&baz=")).toEqual("foo": "bar", "baz": "")
-
-    it 'URL-decodes keys and values', ->
-      expect(toObject("my%20weird%20field=q1%212%22%27w%245%267%2Fz8%29%3F")).toEqual("my weird field": "q1!2\"'w$5&7/z8)?")
-      expect(toObject("a=b&pid%3D1234=1023")).toEqual("pid=1234": "1023", "a": "b")
-      # expect(-> up.params.toObject("foo%81E=1")).toThrowError() # invalid byte sequence in UTF-8
-
-    it 'keeps the last value if the same key appears multiple time in the input', ->
-      expect(toObject("foo=1&bar=2&foo=3")).toEqual("foo": "3", "bar": "2")
-
-    it 'builds an array value if the key ends in "[]"', ->
-      expect(toObject("foo[]=1&bar=2&foo[]=3")).toEqual("foo[]": ["1", "3"], "bar": "2")
-
-    it 'ignores keys that would overwrite an Object prototype property', ->
-      obj = toObject("foo=bar&hasOwnProperty=baz")
-      expect(obj['foo']).toEqual('bar')
-      expect(u.isFunction obj['hasOwnProperty']).toBe(true)
-
-  describe '#add', ->
-
-    it 'adds a single key and value', ->
-      params = new up.Params(foo: 'one')
-      params.add('bar', 'two')
-      expect(params.toObject()).toEqual { foo: 'one', bar: 'two' }
-
-    it 'stores multiple entries with the same name', ->
-      params = new up.Params(foo: 'one')
-      params.add('foo', 'two')
-      expect(params.toArray()).toEqual [
-        { name: 'foo', value: 'one' },
-        { name: 'foo', value: 'two' }
-      ]
-
-  describe '#get', ->
-
-    describe '(with object)', ->
-
-      it 'returns the value for the given name', ->
-        params = new up.Params(foo: 'one', bar: 'two')
-        value = params.get('bar')
-        expect(value).toEqual('two')
-
-      it 'returns undefined if no value is set for the given name', ->
-        params = new up.Params(foo: 'one')
-        value = params.get('bar')
-        expect(value).toBeUndefined()
-
-      it 'returns undefined for names that are also a basic object property', ->
-        params = new up.Params({})
-        value = params.get('hasOwnProperty')
-        expect(value).toBeUndefined()
-
-      it 'returns the first matching entries if there are are multiple entries with the same name', ->
-        params = new up.Params('foo=one&foo=two')
-        value = params.get('foo')
-        expect(value).toEqual('one')
-
-  describe '#getAll', ->
-
-    it 'returns all entries with the given name'
-
-  describe '#delete', ->
-
-    it 'deletes all entries with the given name'
-
-  describe '#set', ->
-
-    it 'adds an entry with the given name and value'
-
-    it 'deletes any previous entries with the same name'
-
-    describe '#toURL', ->
-
-    it 'composes a URL from a base URL (without query section) and a query section', ->
-      base = 'http://foo.bar/path'
-      params = new up.Params('key=value')
-      expect(params.toURL(base)).toEqual('http://foo.bar/path?key=value')
-
-    it 'accepts other forms of params (instead of query sections)', ->
-      base = 'http://foo.bar/path'
-      params = new up.Params(key: 'value')
-      expect(params.toURL(base)).toEqual('http://foo.bar/path?key=value')
-
-    it 'adds more params to a base URL that already has a query section', ->
-      base = 'http://foo.bar/path?key1=value1'
-      params = new up.Params(key2: 'value2')
-      expect(params.toURL(base)).toEqual('http://foo.bar/path?key1=value1&key2=value2')
-
-    it 'does not add a question mark to the base URL if the given params are blank', ->
-      base = 'http://foo.bar/path'
-      params = new up.Params([])
-      expect(params.toURL(base)).toEqual('http://foo.bar/path')
-
-  describe '.fromURL', ->
-
-    it 'parses the query section from an URL, without leading question mark', ->
-      url = 'http://foo.bar/path?key=value'
-      params = up.Params.fromURL(url)
-      expect(params.toQuery()).toEqual('key=value')
-
-    it 'parses no params if the URL has no query section', ->
-      url = 'http://foo.bar/path'
-      params = up.Params.fromURL(url)
-      expect(params.toArray()).toEqual([])
-
-  describe '.fromForm', ->
-
-    it 'serializes a form with multiple inputs', ->
-      $form = $fixture('form')
-      $form.append('<input name="key1" value="value1">')
-      $form.append('<input name="key2" value="value2">')
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key1', value: 'value1' },
-        { name: 'key2', value: 'value2' },
-      ]
-
-    it 'serializes an <input type="text"> with its default [value]', ->
-      $form = $fixture('form')
-      $form.append('<input type="text" name="key" value="value-from-attribute">')
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value-from-attribute' }
-      ]
-
-    it 'serializes an <input type="text"> that had its value property changed by a script', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" name="key" value="value-from-attribute">').appendTo($form)
-      $input[0].value = 'value-from-script'
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value-from-script' }
-      ]
-
-    it 'serializes an <input type="hidden"> with its default [value]', ->
-      $form = $fixture('form')
-      $form.append('<input type="hidden" name="key" value="value-from-attribute">')
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value-from-attribute' }
-      ]
-
-    it 'serializes an <input type="hidden"> that had its value property changed by a script', ->
-      $form = $fixture('form')
-      $input = $('<input type="hidden" name="key" value="value-from-attribute">').appendTo($form)
-      $input[0].value = 'value-from-script'
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value-from-script' }
-      ]
-
-    it 'seralizes a <select> with its default selected option', ->
-      $form = $fixture('form')
-      $select = $('<select name="key"></select>').appendTo($form)
-      $option1 = $('<option value="value1">').appendTo($select)
-      $option2 = $('<option value="value2" selected>').appendTo($select)
-      $option3 = $('<option value="value3">').appendTo($select)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value2' }
-      ]
-
-    it 'seralizes a <select> that had its selection changed by a script', ->
-      $form = $fixture('form')
-      $select = $('<select name="key"></select>').appendTo($form)
-      $option1 = $('<option value="value1">').appendTo($select)
-      $option2 = $('<option value="value2" selected>').appendTo($select)
-      $option3 = $('<option value="value3">').appendTo($select)
-
-      $option2[0].selected = false
-      $option3[0].selected = true
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value3' }
-      ]
-
-    it 'serializes a <select multiple> with multiple selected options into multiple params', ->
-      $form = $fixture('form')
-      $select = $('<select name="key" multiple></select>').appendTo($form)
-      $option1 = $('<option value="value1">').appendTo($select)
-      $option2 = $('<option value="value2" selected>').appendTo($select)
-      $option3 = $('<option value="value3" selected>').appendTo($select)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value2' },
-        { name: 'key', value: 'value3' }
-      ]
-
-    it 'serializes an <input type="file">'
-
-    it 'serializes an <input type="file" multiple> into multiple params'
-
-    it 'includes an <input type="checkbox"> that was [checked] by default', ->
-      $form = $fixture('form')
-      $input = $('<input type="checkbox" name="key" value="value" checked>').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value' }
-      ]
-
-    it 'includes an <input type="checkbox"> that was checked by a script', ->
-      $form = $fixture('form')
-      $input = $('<input type="checkbox" name="key" value="value">').appendTo($form)
-      $input[0].checked = true
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value' }
-      ]
-
-    it 'excludes an <input type="checkbox"> that is unchecked', ->
-      $form = $fixture('form')
-      $input = $('<input type="checkbox" name="key" value="value">').appendTo($form)
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual []
-
-    it 'includes a checked <input type="radio"> in a radio button group that was [checked] by default', ->
-      $form = $fixture('form')
-      $button1 = $('<input type="radio" name="key" value="value1">').appendTo($form)
-      $button2 = $('<input type="radio" name="key" value="value2" checked>').appendTo($form)
-      $button3 = $('<input type="radio" name="key" value="value3">').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value2' }
-      ]
-
-    it 'includes a checked <input type="radio"> in a radio button group that was checked by a script', ->
-      $form = $fixture('form')
-      $button1 = $('<input type="radio" name="key" value="value1">').appendTo($form)
-      $button2 = $('<input type="radio" name="key" value="value2" checked>').appendTo($form)
-      $button3 = $('<input type="radio" name="key" value="value3">').appendTo($form)
-
-      $button2[0].checked = false
-      $button3[0].checked = true
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value3' }
-      ]
-
-    it 'excludes an radio button group if no button is selected', ->
-      $form = $fixture('form')
-      $button1 = $('<input type="radio" name="key" value="value1">').appendTo($form)
-      $button2 = $('<input type="radio" name="key" value="value2">').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual []
-
-    it 'excludes an <input> that is [disabled] by default', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" name="key" value="value" disabled>').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual []
-
-    it 'excludes an <input> that was disabled by a script', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" name="key" value="value">').appendTo($form)
-      $input[0].disabled = true
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual []
-
-    it 'excludes an <input> without a [name] attribute', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" value="value">').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual []
-
-    it 'includes an <input readonly>', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" name="key" value="value" readonly>').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'key', value: 'value' }
-      ]
-
-    it 'includes the focused submit button', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" name="input-key" value="input-value">').appendTo($form)
-      $submit1 = $('<button type="submit" name="submit1-key" value="submit1-value">').appendTo($form)
-      $submit2 = $('<input type="submit" name="submit2-key" value="submit2-value">').appendTo($form)
-      $submit3 = $('<input type="submit" name="submit3-key" value="submit3-value">').appendTo($form)
-
-      $submit2.focus()
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'input-key', value: 'input-value' },
-        { name: 'submit2-key', value: 'submit2-value' }
-      ]
-
-    it 'includes a the first submit button if no button is focused', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" name="input-key" value="input-value">').appendTo($form)
-      $submit1 = $('<button type="submit" name="submit1-key" value="submit1-value">').appendTo($form)
-      $submit2 = $('<input type="submit" name="submit2-key" value="submit2-value">').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'input-key', value: 'input-value' },
-        { name: 'submit1-key', value: 'submit1-value' }
-      ]
-
-    it 'excludes a submit button without a [name] attribute', ->
-      $form = $fixture('form')
-      $input = $('<input type="text" name="input-key" value="input-value">').appendTo($form)
-      $submit = $('<button type="submit" value="submit-value">').appendTo($form)
-
-      params = up.Params.fromForm($form)
-      expect(params.toArray()).toEqual [
-        { name: 'input-key', value: 'input-value' }
-      ]
-
-

data/spec_app/spec/javascripts/up/classes/request_spec.coffee

@@ -1,50 +0,0 @@
-u = up.util
-$ = jQuery
-
-describe 'up.Request', ->
-
-  describe '#url', ->
-
-    it 'returns the given URL', ->
-      request = new up.Request(url: 'http://host.com/foo')
-      expect(request.url).toEqual('http://host.com/foo')
-
-    it 'does not include a hash anchor of the constructed URL', ->
-      request = new up.Request(url: 'http://host.com/foo#hash')
-      expect(request.url).toEqual('http://host.com/foo')
-
-    it "merges { params } for HTTP methods that don't allow a payload", ->
-      request = new up.Request(url: 'http://host.com/foo?urlKey=urlValue', params: { paramsKey: 'paramsValue' }, method: 'get')
-      expect(request.url).toEqual('http://host.com/foo?urlKey=urlValue&paramsKey=paramsValue')
-
-    it 'keeps query params in the URL for HTTP methods that allow a payload', ->
-      request = new up.Request(url: 'http://host.com/foo?key=value', method: 'post')
-      expect(request.url).toEqual('http://host.com/foo?key=value')
-      expect(request.params).toBeBlank()
-
-  describe '#method', ->
-
-    it 'defaults to "GET"', ->
-      request = new up.Request(url: 'http://host.com/foo')
-      expect(request.method).toEqual('GET')
-
-  describe '#hash', ->
-
-    it 'returns the hash anchor from the constructed URL', ->
-      request = new up.Request(url: 'http://host.com/foo#hash')
-      expect(request.hash).toEqual('#hash')
-
-    it 'returns undefined if the constructed URL had no hash anchor', ->
-      request = new up.Request(url: 'http://host.com/foo')
-      expect(request.hash).toBeUndefined()
-
-  describe '#params', ->
-
-    it 'returns the constructed params for HTTP methods that allow a payload', ->
-      params = { key: 'value' }
-      request = new up.Request(url: 'http://host.com/foo', params: params, method: 'post')
-      expect(request.params).toEqual(new up.Params(params))
-
-    it "returns a blank up.Params object for HTTP methods that don't allow a payload", ->
-      request = new up.Request(url: 'http://host.com/foo', params: { key: 'value' }, method: 'get')
-      expect(request.params).toBeBlank()

data/spec_app/spec/javascripts/up/classes/scroll_motion_spec.js.coffee

@@ -1,51 +0,0 @@
-u = up.util
-$ = jQuery
-
-describe 'up.ScrollMotion', ->
-
-  beforeEach ->
-    @$viewport = $fixture('.viewport').css
-      height: '100px'
-      overflowY: 'scroll'
-
-    @$content = @$viewport.affix('.content').css
-      height: '10000px'
-
-  describe 'constructor', ->
-
-    it 'does not start scrolling', ->
-      motion = new up.ScrollMotion(@$viewport[0], 530)
-      expect(@$viewport.scrollTop()).toEqual(0)
-
-  describe '#start()', ->
-
-    describe '(without { behavior } option)', ->
-
-      it 'abruptly scrolls the given element to the given y-position', ->
-        motion = new up.ScrollMotion(@$viewport[0], 530)
-
-        motion.start()
-
-        expect(@$viewport.scrollTop()).toEqual(530)
-
-    describe '(with { behavior: "scroll" } option)', ->
-
-      it 'animates the scrolling to the given y-position', asyncSpec (next) ->
-        motion = new up.ScrollMotion(@$viewport[0], 2050, { behavior: 'smooth' })
-
-        scrollDone = motion.start()
-
-        next.after 100, =>
-          expect(@$viewport.scrollTop()).toBeAround(1, 500)
-
-          next.await(scrollDone)
-
-        next =>
-          expect(@$viewport.scrollTop())
-
-      it "aborts the scrolling animation if the user or another script changes the viewport's scrollTop during the animation"
-
-  describe '#finish()', ->
-
-    it 'abruptly finishes the scrolling animation by setting the target y-position'
-