mattermost/e2e-tests/cypress/tests/support/api/scheme.d.ts
2023-03-28 18:10:00 +02:00

45 lines
1.8 KiB
TypeScript

// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
// See LICENSE.txt for license information.
/// <reference types="cypress" />
// ***************************************************************
// Each command should be properly documented using JSDoc.
// See https://jsdoc.app/index.html for reference.
// Basic requirements for documentation are the following:
// - Meaningful description
// - Specific link to https://api.mattermost.com
// - Each parameter with `@params`
// - Return value with `@returns`
// - Example usage with `@example`
// Custom command should follow naming convention of having `api` prefix, e.g. `apiLogin`.
// ***************************************************************
declare namespace Cypress {
interface Chainable {
/**
* Get the schemes.
* See https://api.mattermost.com/#tag/schemes/paths/~1schemes/get
* @param {string} scope - Limit the results returned to the provided scope, either team or channel.
* @returns {Scheme[]} `out.schemes` as `Scheme[]`
*
* @example
* cy.apiGetSchemes('team').then(({schemes}) => {
* // do something with schemes
* });
*/
apiGetSchemes(scope: string): Chainable<{schemes: Scheme[]}>;
/**
* Delete a scheme.
* See https://api.mattermost.com/#tag/schemes/paths/~1schemes~1{scheme_id}/delete
* @param {string} schemeId - ID of the scheme to delete
* @returns {Response} response: Cypress-chainable response which should have successful HTTP status of 200 OK to continue or pass.
*
* @example
* cy.apiDeleteScheme('scheme_id');
*/
apiDeleteScheme(schemeId: string): Chainable<Response>;
}
}