br-dionysus 1.17.7 → 1.18.0

package/cypress/e2e/2-advanced-examples/traversal.cy.js

@@ -0,0 +1,121 @@
+/// <reference types="cypress" />
+
+context('Traversal', () => {
+  beforeEach(() => {
+    cy.visit('https://example.cypress.io/commands/traversal')
+  })
+
+  it('.children() - get child DOM elements', () => {
+    // https://on.cypress.io/children
+    cy.get('.traversal-breadcrumb')
+      .children('.active')
+      .should('contain', 'Data')
+  })
+
+  it('.closest() - get closest ancestor DOM element', () => {
+    // https://on.cypress.io/closest
+    cy.get('.traversal-badge')
+      .closest('ul')
+      .should('have.class', 'list-group')
+  })
+
+  it('.eq() - get a DOM element at a specific index', () => {
+    // https://on.cypress.io/eq
+    cy.get('.traversal-list>li')
+      .eq(1).should('contain', 'siamese')
+  })
+
+  it('.filter() - get DOM elements that match the selector', () => {
+    // https://on.cypress.io/filter
+    cy.get('.traversal-nav>li')
+      .filter('.active').should('contain', 'About')
+  })
+
+  it('.find() - get descendant DOM elements of the selector', () => {
+    // https://on.cypress.io/find
+    cy.get('.traversal-pagination')
+      .find('li').find('a')
+      .should('have.length', 7)
+  })
+
+  it('.first() - get first DOM element', () => {
+    // https://on.cypress.io/first
+    cy.get('.traversal-table td')
+      .first().should('contain', '1')
+  })
+
+  it('.last() - get last DOM element', () => {
+    // https://on.cypress.io/last
+    cy.get('.traversal-buttons .btn')
+      .last().should('contain', 'Submit')
+  })
+
+  it('.next() - get next sibling DOM element', () => {
+    // https://on.cypress.io/next
+    cy.get('.traversal-ul')
+      .contains('apples').next().should('contain', 'oranges')
+  })
+
+  it('.nextAll() - get all next sibling DOM elements', () => {
+    // https://on.cypress.io/nextall
+    cy.get('.traversal-next-all')
+      .contains('oranges')
+      .nextAll().should('have.length', 3)
+  })
+
+  it('.nextUntil() - get next sibling DOM elements until next el', () => {
+    // https://on.cypress.io/nextuntil
+    cy.get('#veggies')
+      .nextUntil('#nuts').should('have.length', 3)
+  })
+
+  it('.not() - remove DOM elements from set of DOM elements', () => {
+    // https://on.cypress.io/not
+    cy.get('.traversal-disabled .btn')
+      .not('[disabled]').should('not.contain', 'Disabled')
+  })
+
+  it('.parent() - get parent DOM element from DOM elements', () => {
+    // https://on.cypress.io/parent
+    cy.get('.traversal-mark')
+      .parent().should('contain', 'Morbi leo risus')
+  })
+
+  it('.parents() - get parent DOM elements from DOM elements', () => {
+    // https://on.cypress.io/parents
+    cy.get('.traversal-cite')
+      .parents().should('match', 'blockquote')
+  })
+
+  it('.parentsUntil() - get parent DOM elements from DOM elements until el', () => {
+    // https://on.cypress.io/parentsuntil
+    cy.get('.clothes-nav')
+      .find('.active')
+      .parentsUntil('.clothes-nav')
+      .should('have.length', 2)
+  })
+
+  it('.prev() - get previous sibling DOM element', () => {
+    // https://on.cypress.io/prev
+    cy.get('.birds').find('.active')
+      .prev().should('contain', 'Lorikeets')
+  })
+
+  it('.prevAll() - get all previous sibling DOM elements', () => {
+    // https://on.cypress.io/prevall
+    cy.get('.fruits-list').find('.third')
+      .prevAll().should('have.length', 2)
+  })
+
+  it('.prevUntil() - get all previous sibling DOM elements until el', () => {
+    // https://on.cypress.io/prevuntil
+    cy.get('.foods-list').find('#nuts')
+      .prevUntil('#veggies').should('have.length', 3)
+  })
+
+  it('.siblings() - get all sibling DOM elements', () => {
+    // https://on.cypress.io/siblings
+    cy.get('.traversal-pills .active')
+      .siblings().should('have.length', 2)
+  })
+})

package/cypress/e2e/2-advanced-examples/utilities.cy.js

@@ -0,0 +1,107 @@
+/// <reference types="cypress" />
+
+context('Utilities', () => {
+  beforeEach(() => {
+    cy.visit('https://example.cypress.io/utilities')
+  })
+
+  it('Cypress._ - call a lodash method', () => {
+    // https://on.cypress.io/_
+    cy.request('https://jsonplaceholder.cypress.io/users')
+      .then((response) => {
+        let ids = Cypress._.chain(response.body).map('id').take(3).value()
+
+        expect(ids).to.deep.eq([1, 2, 3])
+      })
+  })
+
+  it('Cypress.$ - call a jQuery method', () => {
+    // https://on.cypress.io/$
+    let $li = Cypress.$('.utility-jquery li:first')
+
+    cy.wrap($li).should('not.have.class', 'active')
+    cy.wrap($li).click()
+    cy.wrap($li).should('have.class', 'active')
+  })
+
+  it('Cypress.Blob - blob utilities and base64 string conversion', () => {
+    // https://on.cypress.io/blob
+    cy.get('.utility-blob').then(($div) => {
+      // https://github.com/nolanlawson/blob-util#imgSrcToDataURL
+      // get the dataUrl string for the javascript-logo
+      return Cypress.Blob.imgSrcToDataURL('https://example.cypress.io/assets/img/javascript-logo.png', undefined, 'anonymous')
+      .then((dataUrl) => {
+        // create an <img> element and set its src to the dataUrl
+        let img = Cypress.$('<img />', { src: dataUrl })
+
+        // need to explicitly return cy here since we are initially returning
+        // the Cypress.Blob.imgSrcToDataURL promise to our test
+        // append the image
+        $div.append(img)
+
+        cy.get('.utility-blob img').click()
+        cy.get('.utility-blob img').should('have.attr', 'src', dataUrl)
+      })
+    })
+  })
+
+  it('Cypress.minimatch - test out glob patterns against strings', () => {
+    // https://on.cypress.io/minimatch
+    let matching = Cypress.minimatch('/users/1/comments', '/users/*/comments', {
+      matchBase: true,
+    })
+
+    expect(matching, 'matching wildcard').to.be.true
+
+    matching = Cypress.minimatch('/users/1/comments/2', '/users/*/comments', {
+      matchBase: true,
+    })
+
+    expect(matching, 'comments').to.be.false
+
+    // ** matches against all downstream path segments
+    matching = Cypress.minimatch('/foo/bar/baz/123/quux?a=b&c=2', '/foo/**', {
+      matchBase: true,
+    })
+
+    expect(matching, 'comments').to.be.true
+
+    // whereas * matches only the next path segment
+
+    matching = Cypress.minimatch('/foo/bar/baz/123/quux?a=b&c=2', '/foo/*', {
+      matchBase: false,
+    })
+
+    expect(matching, 'comments').to.be.false
+  })
+
+  it('Cypress.Promise - instantiate a bluebird promise', () => {
+    // https://on.cypress.io/promise
+    let waited = false
+
+    /**
+     * @return Bluebird<string>
+     */
+    function waitOneSecond () {
+      // return a promise that resolves after 1 second
+      return new Cypress.Promise((resolve, reject) => {
+        setTimeout(() => {
+          // set waited to true
+          waited = true
+
+          // resolve with 'foo' string
+          resolve('foo')
+        }, 1000)
+      })
+    }
+
+    cy.then(() => {
+      // return a promise to cy.then() that
+      // is awaited until it resolves
+      return waitOneSecond().then((str) => {
+        expect(str).to.eq('foo')
+        expect(waited).to.be.true
+      })
+    })
+  })
+})

package/cypress/e2e/2-advanced-examples/viewport.cy.js

@@ -0,0 +1,58 @@
+/// <reference types="cypress" />
+context('Viewport', () => {
+  beforeEach(() => {
+    cy.visit('https://example.cypress.io/commands/viewport')
+  })
+
+  it('cy.viewport() - set the viewport size and dimension', () => {
+    // https://on.cypress.io/viewport
+
+    cy.get('#navbar').should('be.visible')
+    cy.viewport(320, 480)
+
+    // the navbar should have collapse since our screen is smaller
+    cy.get('#navbar').should('not.be.visible')
+    cy.get('.navbar-toggle').should('be.visible').click()
+    cy.get('.nav').find('a').should('be.visible')
+
+    // lets see what our app looks like on a super large screen
+    cy.viewport(2999, 2999)
+
+    // cy.viewport() accepts a set of preset sizes
+    // to easily set the screen to a device's width and height
+
+    // We added a cy.wait() between each viewport change so you can see
+    // the change otherwise it is a little too fast to see :)
+
+    cy.viewport('macbook-15')
+    cy.wait(200)
+    cy.viewport('macbook-13')
+    cy.wait(200)
+    cy.viewport('macbook-11')
+    cy.wait(200)
+    cy.viewport('ipad-2')
+    cy.wait(200)
+    cy.viewport('ipad-mini')
+    cy.wait(200)
+    cy.viewport('iphone-6+')
+    cy.wait(200)
+    cy.viewport('iphone-6')
+    cy.wait(200)
+    cy.viewport('iphone-5')
+    cy.wait(200)
+    cy.viewport('iphone-4')
+    cy.wait(200)
+    cy.viewport('iphone-3')
+    cy.wait(200)
+
+    // cy.viewport() accepts an orientation for all presets
+    // the default orientation is 'portrait'
+    cy.viewport('ipad-2', 'portrait')
+    cy.wait(200)
+    cy.viewport('iphone-4', 'landscape')
+    cy.wait(200)
+
+    // The viewport will be reset back to the default dimensions
+    // in between tests (the  default can be set in cypress.config.{js|ts})
+  })
+})

package/cypress/e2e/2-advanced-examples/waiting.cy.js

@@ -0,0 +1,30 @@
+/// <reference types="cypress" />
+context('Waiting', () => {
+  beforeEach(() => {
+    cy.visit('https://example.cypress.io/commands/waiting')
+  })
+  // BE CAREFUL of adding unnecessary wait times.
+  // https://on.cypress.io/best-practices#Unnecessary-Waiting
+
+  // https://on.cypress.io/wait
+  it('cy.wait() - wait for a specific amount of time', () => {
+    cy.get('.wait-input1').type('Wait 1000ms after typing')
+    cy.wait(1000)
+    cy.get('.wait-input2').type('Wait 1000ms after typing')
+    cy.wait(1000)
+    cy.get('.wait-input3').type('Wait 1000ms after typing')
+    cy.wait(1000)
+  })
+
+  it('cy.wait() - wait for a specific route', () => {
+    // Listen to GET to comments/1
+    cy.intercept('GET', '**/comments/*').as('getComment')
+
+    // we have code that gets a comment when
+    // the button is clicked in scripts.js
+    cy.get('.network-btn').click()
+
+    // wait for GET comments/1
+    cy.wait('@getComment').its('response.statusCode').should('be.oneOf', [200, 304])
+  })
+})

package/cypress/e2e/2-advanced-examples/window.cy.js

@@ -0,0 +1,22 @@
+/// <reference types="cypress" />
+
+context('Window', () => {
+  beforeEach(() => {
+    cy.visit('https://example.cypress.io/commands/window')
+  })
+
+  it('cy.window() - get the global window object', () => {
+    // https://on.cypress.io/window
+    cy.window().should('have.property', 'top')
+  })
+
+  it('cy.document() - get the document object', () => {
+    // https://on.cypress.io/document
+    cy.document().should('have.property', 'charset').and('eq', 'UTF-8')
+  })
+
+  it('cy.title() - get the title', () => {
+    // https://on.cypress.io/title
+    cy.title().should('include', 'Kitchen Sink')
+  })
+})

package/cypress/e2e/toolSlotsToData.cy.ts

@@ -0,0 +1,127 @@
+import slotsToData, { type SlotsToDataReturn, type SlotsToDataReturnItem } from '../../packages/Tool/slotsToData/slotsToData'
+
+type VNodeType = { name: string } | symbol
+interface VNodeLike {
+  type: VNodeType
+  props?: Record<string, unknown>
+  children?: VNodeLike[]
+}
+
+const createNode = (name: string, props: Record<string, unknown> = {}, children: VNodeLike[] = []): VNodeLike => ({
+  type: { name },
+  props,
+  children
+})
+
+describe('工具函数 slotsToData', () => {
+  it('默认插槽解析', () => {
+    const slots = {
+      default: () => [
+        createNode('ElDiv', { a: 1 }),
+        createNode('ElSpan', { b: 2 })
+      ]
+    }
+    const res: SlotsToDataReturn = slotsToData(slots)
+    expect(res).to.have.length(2)
+    expect(res[0].name).to.equal('ElDiv')
+    expect(res[0].props).to.deep.equal({ a: 1 })
+    expect(res[0].children).to.deep.equal([])
+    expect(res[1].name).to.equal('ElSpan')
+  })
+
+  it('指定插槽名 inlineBtn', () => {
+    const slots = {
+      inlineBtn: () => [
+        createNode('ElButton', { type: 'primary' })
+      ]
+    }
+    const res: SlotsToDataReturn = slotsToData(slots, { name: 'inlineBtn' })
+    expect(res).to.have.length(1)
+    expect(res[0].name).to.equal('ElButton')
+    expect(res[0].props).to.deep.equal({ type: 'primary' })
+  })
+
+  it('跳过注释节点 isJumpFgt=true', () => {
+    const slots = {
+      default: () => [
+        { type: Symbol('fgt') as symbol, props: {}, children: [] },
+        createNode('ElTag', { effect: 'light' })
+      ]
+    }
+    const res = slotsToData(slots)
+    expect(res).to.have.length(1)
+    expect(res[0].name).to.equal('ElTag')
+  })
+
+  it('不跳过注释节点 isJumpFgt=false', () => {
+    const comment: VNodeLike = { type: Symbol('fgt'), props: {}, children: [] }
+    const slots = {
+      default: () => [comment]
+    }
+    const res = slotsToData(slots, { isJumpFgt: false })
+    expect(res).to.have.length(1)
+    expect(res[0].name).to.equal(undefined)
+    expect(res[0].children).to.deep.equal([])
+  })
+
+  it('递归解析 children', () => {
+    const slots = {
+      default: () => [
+        createNode('ElDiv', {}, [
+          createNode('ElSpan', { text: 'A' }),
+          createNode('ElSpan', { text: 'B' })
+        ])
+      ]
+    }
+    const res = slotsToData(slots)
+    expect(res).to.have.length(1)
+    expect(res[0].children).to.have.length(2)
+    expect(res[0].children[0].name).to.equal('ElSpan')
+    expect(res[0].children[0].props).to.deep.equal({ text: 'A' })
+  })
+
+  it('限制递归最大深度 maxDepth=1', () => {
+    const slots = {
+      default: () => [
+        createNode('ElDiv', {}, [
+          createNode('ElSpan', { text: 'A' })
+        ])
+      ]
+    }
+    const res = slotsToData(slots, { maxDepth: 1 })
+    expect(res).to.have.length(1)
+    expect(res[0].children).to.deep.equal([])
+  })
+
+  it('插槽函数抛错时返回空数组', () => {
+    const slots = {
+      default: () => {
+        throw new Error('boom')
+      }
+    }
+    const res = slotsToData(slots)
+    expect(res).to.deep.equal([])
+  })
+
+  it('不存在的插槽名返回空数组', () => {
+    const slots = {
+      default: () => [createNode('ElDiv')]
+    }
+    const res = slotsToData(slots, { name: 'submitBtn' })
+    expect(res).to.deep.equal([])
+  })
+
+  it('props 与 children 字段完整性', () => {
+    const slots = {
+      default: () => [
+        createNode('ElRow', { gutter: 12 }, [
+          createNode('ElCol', { span: 6 })
+        ])
+      ]
+    }
+    const res: SlotsToDataReturn = slotsToData(slots)
+    const first: SlotsToDataReturnItem = res[0]
+    expect(first.props).to.deep.equal({ gutter: 12 })
+    expect(first.children[0].props).to.deep.equal({ span: 6 })
+  })
+})

package/cypress/e2e/toolUniqueByKey.cy.ts

@@ -0,0 +1,79 @@
+import uniqueByKey from '../../packages/Tool/uniqueByKey/uniqueByKey'
+
+interface StrItem { id: string; name: string }
+interface NumItem { id: number; name: string }
+interface OptItem { id?: string; name: string }
+interface BoolItem { active: boolean; label: string }
+interface ObjKeyItem { key: { v: number }; id: number }
+
+describe('工具函数 uniqueByKey', () => {
+  it('字符串键去重并保持首次出现顺序', () => {
+    const arr: StrItem[] = [
+      { id: 'a', name: 'A1' },
+      { id: 'b', name: 'B1' },
+      { id: 'a', name: 'A2' },
+      { id: 'c', name: 'C1' },
+      { id: 'b', name: 'B2' }
+    ]
+    const res = uniqueByKey(arr, 'id')
+    expect(res.map(i => i.id)).to.deep.equal(['a', 'b', 'c'])
+    expect(res[0].name).to.equal('A1')
+    expect(res[1].name).to.equal('B1')
+    expect(res[2].name).to.equal('C1')
+  })
+
+  it('数字键去重', () => {
+    const arr: NumItem[] = [
+      { id: 1, name: 'N1' },
+      { id: 2, name: 'N2' },
+      { id: 1, name: 'N1-dup' },
+      { id: 3, name: 'N3' }
+    ]
+    const res = uniqueByKey(arr, 'id')
+    expect(res.map(i => i.id)).to.deep.equal([1, 2, 3])
+  })
+
+  it('空数组返回空数组', () => {
+    const arr: StrItem[] = []
+    const res = uniqueByKey(arr, 'id')
+    expect(res).to.deep.equal([])
+  })
+
+  it('可选键值为 undefined 的处理，仅保留首个 undefined', () => {
+    const arr: OptItem[] = [
+      { name: 'X' },
+      { name: 'Y' },
+      { id: '1', name: 'Z1' },
+      { id: '1', name: 'Z2' }
+    ]
+    const res = uniqueByKey(arr, 'id')
+    expect(res.length).to.equal(2)
+    expect(res[0].id).to.equal(undefined)
+    expect(res[0].name).to.equal('X')
+    expect(res[1].id).to.equal('1')
+    expect(res[1].name).to.equal('Z1')
+  })
+
+  it('布尔键去重', () => {
+    const arr: BoolItem[] = [
+      { active: true, label: 'A' },
+      { active: false, label: 'B' },
+      { active: true, label: 'A-dup' }
+    ]
+    const res = uniqueByKey(arr, 'active')
+    expect(res.map(i => i.active)).to.deep.equal([true, false])
+  })
+
+  it('对象键按引用去重（同引用合并，不同引用保留）', () => {
+    const same = { v: 1 }
+    const arr: ObjKeyItem[] = [
+      { key: same, id: 1 },
+      { key: same, id: 2 },
+      { key: { v: 1 }, id: 3 }
+    ]
+    const res = uniqueByKey(arr, 'key')
+    expect(res.length).to.equal(2)
+    expect(res[0].id).to.equal(1)
+    expect(res[1].id).to.equal(3)
+  })
+})

package/cypress/support/component.ts

@@ -20,6 +20,10 @@ import './commands'
 // require('./commands')
 
 import { mount } from 'cypress/vue'
+import ElementPlus from 'element-plus'
+import 'element-plus/dist/index.css'
+import * as ElementPlusIconsVue from '@element-plus/icons-vue'
+import dionysus from '../../packages'
 
 // Augment the Cypress namespace to include type definitions for
 // your custom command.
@@ -33,7 +37,22 @@ declare global {
   }
 }
 
-Cypress.Commands.add('mount', mount)
+Cypress.Commands.add('mount', (component, options = {}) => {
+  options.global = options.global || {}
+  options.global.plugins = options.global.plugins || []
+  options.global.components = options.global.components || {}
+
+  // 注册 ElementPlus
+  options.global.plugins.push(ElementPlus)
+  options.global.plugins.push(dionysus)
+
+  // 注册所有图标组件
+  for (const [key, icon] of Object.entries(ElementPlusIconsVue)) {
+    options.global.components[key] = icon
+  }
+
+  return mount(component, options)
+})
 
 // Example use:
 // cy.mount(MyComponent)

package/cypress.config.ts

@@ -1,6 +1,7 @@
 import { defineConfig } from 'cypress'
 
 export default defineConfig({
+  projectId: 'gtk9e8',
   e2e: {
     setupNodeEvents (on, config) {
       // implement node event listeners here