// Licensed to the Software Freedom Conservancy (SFC) under one // or more contributor license agreements. See the NOTICE file // distributed with this work for additional information // regarding copyright ownership. The SFC licenses this file // to you under the Apache License, Version 2.0 (the // "License"); you may not use this file except in compliance // with the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, // software distributed under the License is distributed on an // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY // KIND, either express or implied. See the License for the // specific language governing permissions and limitations // under the License. 'use strict'; var assert = require('assert'); var by = require('../../lib/by'); describe('by', function() { describe('By', function() { describe('className', function() { it('delegates to By.css', function() { let locator = by.By.className('foo'); assert.equal('css selector', locator.using); assert.equal('.foo', locator.value); }); it('escapes class name', function() { let locator = by.By.className('foo#bar'); assert.equal('css selector', locator.using); assert.equal('.foo\\#bar', locator.value); }); it('translates compound class names', function() { let locator = by.By.className('a b'); assert.equal('css selector', locator.using); assert.equal('.a.b', locator.value); locator = by.By.className(' x y z-1 "g" '); assert.equal('css selector', locator.using); assert.equal('.x.y.z-1.\\"g\\"', locator.value); }); }); describe('id', function() { it('delegates to By.css', function() { let locator = by.By.id('foo'); assert.equal('css selector', locator.using); assert.equal('*[id="foo"]', locator.value); }); it('escapes the ID', function() { let locator = by.By.id('foo#bar'); assert.equal('css selector', locator.using); assert.equal('*[id="foo\\#bar"]', locator.value); }); }); describe('name', function() { it('delegates to By.css', function() { let locator = by.By.name('foo') assert.equal('css selector', locator.using); assert.equal('*[name="foo"]', locator.value); }); it('escapes the name', function() { let locator = by.By.name('foo"bar"') assert.equal('css selector', locator.using); assert.equal('*[name="foo\\"bar\\""]', locator.value); }); it('escapes the name when it starts with a number', function() { let locator = by.By.name('123foo"bar"') assert.equal('css selector', locator.using); assert.equal('*[name="\\31 23foo\\"bar\\""]', locator.value); }); it('escapes the name when it starts with a negative number', function() { let locator = by.By.name('-123foo"bar"') assert.equal('css selector', locator.using); assert.equal('*[name="-\\31 23foo\\"bar\\""]', locator.value); }); }); }); describe('checkedLocator', function() { it('accepts a By instance', function() { let original = by.By.name('foo'); let locator = by.checkedLocator(original); assert.strictEqual(locator, original); }); it('accepts custom locator functions', function() { let original = function() {}; let locator = by.checkedLocator(original); assert.strictEqual(locator, original); }); // See https://github.com/SeleniumHQ/selenium/issues/3056 it('accepts By-like objects', function() { let fakeBy = {using: 'id', value: 'foo'}; let locator = by.checkedLocator(fakeBy); assert.strictEqual(locator.constructor, by.By); assert.equal(locator.using, 'id'); assert.equal(locator.value, 'foo'); }); it('accepts class name', function() { let locator = by.checkedLocator({className: 'foo'}); assert.equal('css selector', locator.using); assert.equal('.foo', locator.value); }); it('accepts css', function() { let locator = by.checkedLocator({css: 'a > b'}); assert.equal('css selector', locator.using); assert.equal('a > b', locator.value); }); it('accepts id', function() { let locator = by.checkedLocator({id: 'foobar'}); assert.equal('css selector', locator.using); assert.equal('*[id="foobar"]', locator.value); }); it('accepts linkText', function() { let locator = by.checkedLocator({linkText: 'hello'}); assert.equal('link text', locator.using); assert.equal('hello', locator.value); }); it('accepts name', function() { let locator = by.checkedLocator({name: 'foobar'}); assert.equal('css selector', locator.using); assert.equal('*[name="foobar"]', locator.value); }); it('accepts partialLinkText', function() { let locator = by.checkedLocator({partialLinkText: 'hello'}); assert.equal('partial link text', locator.using); assert.equal('hello', locator.value); }); it('accepts tagName', function() { let locator = by.checkedLocator({tagName: 'div'}); assert.equal('css selector', locator.using); assert.equal('div', locator.value); }); it('accepts xpath', function() { let locator = by.checkedLocator({xpath: '//div[1]'}); assert.equal('xpath', locator.using); assert.equal('//div[1]', locator.value); }); }); });