azure-devops-extension-sdk package
Интерфейсы
| ContextIdentifier | |
| GlobalizationContext | |
| IExtensionContext |
Идентификатор текущего расширения |
| IExtensionInitOptions |
Параметры инициализации расширения — переданы в DevOps.init() |
| IHostContext |
Сведения о текущем узле DevOps (организация) |
| IPageContext |
Глобальный контекст, размещенный на каждой веб-странице |
| ITeamContext |
Сведения о текущей команде DevOps |
| IUserContext |
Сведения о текущем пользователе |
Перечисления
| HostType |
Уровень узла DevOps |
Функции
| apply |
Применение переменных темы к текущему документу |
| disable |
Отключает мост аутентификации вложенных приложений. После этого вызова любые запросы на токены MSAL получат |
| enable |
Включите аутентификацию вложенных приложений (NAA) для этого расширения. Настраивает Называйте это после Пример
|
| get |
Получение маркера доступа, который позволит выполнять вызовы к другим службам DevOps |
| get |
Получение маркера, который можно использовать для идентификации текущего пользователя |
| get |
Получение данных конфигурации, переданных в начальном подтверждении из родительского кадра |
| get |
Возвращает сведения о вкладе, который сначала вызвал загрузку этого расширения. |
| get |
Получение контекста о расширении, которому принадлежит содержимое, размещенное |
| get |
Получает сведения о узле (т. е. организации Azure DevOps), на которую ориентирована страница. |
| get |
Получение контекста о странице узла |
| get |
Получите вклад с указанным идентификатором вклада. Возвращаемый вклад имеет метод получения зарегистрированного объекта в рамках этого вклада. |
| get |
Получает сведения о команде, на которую ориентирована страница |
| get |
Возвращает сведения о текущем пользователе |
| get |
Получение контекста о Интернете |
| init(IExtension |
Инициирует подтверждение с помощью окна узла. |
| notify |
Уведомляет узел о том, что расширение не удалось загрузить |
| notify |
Уведомляет узел о том, что расширение успешно загружено (остановите отображение индикатора загрузки) |
| ready() | Зарегистрируйте обратный вызов, который вызывается после завершения начальной установки или подтверждения. Если начальная настройка уже завершена, обратный вызов вызывается в конце текущего стека вызовов. |
| register<T>(string, T) | Зарегистрируйте объект (метод экземпляра или фабрики), который этот расширение предоставляет кадру узла. |
| resize(number, number) | Запрашивает родительское окно, чтобы изменить размер контейнера для этого расширения на основе текущего размера расширения. |
| unregister(string) | Удаляет объект, предоставляемый этим расширением для кадра узла. |
Переменные
| sdk |
Номер версии веб-SDK. Можно задать в наборе требований расширения, например: vss-sdk-version/4.2 |
Сведения о функции
applyTheme({[varName: string]: string})
Применение переменных темы к текущему документу
function applyTheme(themeData: {[varName: string]: string})
Параметры
- themeData
-
{[varName: string]: string}
disableNestedAppAuth()
Отключает мост аутентификации вложенных приложений. После этого вызова любые запросы на токены MSAL получат BridgeDisabled ошибку. Объект моста остаётся включённым window.nestedAppAuthBridge , чтобы существующие слушатели MSAL не остались сиротами. Позвоните enableNestedAppAuth() для повторного включения.
function disableNestedAppAuth()
enableNestedAppAuth()
Включите аутентификацию вложенных приложений (NAA) для этого расширения.
Настраивает window.nestedAppAuthBridge так, что MSAL createNestablePublicClientApplication могут делегировать получение токенов на Azure DevOps хост-фрейм. Это позволяет избежать проблем с кросс-оригингом BroadcastChannel, блокирующих аутентификация на основе всплывающих окон в iframes.
Называйте это после init() и до создания инстанса MSAL.
Требуется, чтобы хост имел включённую поддержку NAA.
Пример
await SDK.init();
await SDK.enableNestedAppAuth();
const pca = await createNestablePublicClientApplication({
auth: { clientId: "your-entra-client-id" }
});
function enableNestedAppAuth(): Promise<void>
Возвращаемое значение
Promise<void>
Обещание, которое разрешается, когда мост готов, или отклоняется, если хост не поддерживает NAA.
getAccessToken()
Получение маркера доступа, который позволит выполнять вызовы к другим службам DevOps
function getAccessToken(): Promise<string>
Возвращаемое значение
Promise<string>
getAppToken()
Получение маркера, который можно использовать для идентификации текущего пользователя
function getAppToken(): Promise<string>
Возвращаемое значение
Promise<string>
getConfiguration()
Получение данных конфигурации, переданных в начальном подтверждении из родительского кадра
function getConfiguration(): {[key: string]: any}
Возвращаемое значение
{[key: string]: any}
getContributionId()
Возвращает сведения о вкладе, который сначала вызвал загрузку этого расширения.
function getContributionId(): string
Возвращаемое значение
string
getExtensionContext()
Получение контекста о расширении, которому принадлежит содержимое, размещенное
function getExtensionContext(): IExtensionContext
Возвращаемое значение
getHost()
Получает сведения о узле (т. е. организации Azure DevOps), на которую ориентирована страница.
function getHost(): IHostContext
Возвращаемое значение
getPageContext()
Получение контекста о странице узла
function getPageContext(): IPageContext
Возвращаемое значение
getService<T>(string)
Получите вклад с указанным идентификатором вклада. Возвращаемый вклад имеет метод получения зарегистрированного объекта в рамках этого вклада.
function getService<T>(contributionId: string): Promise<T>
Параметры
- contributionId
-
string
Идентификатор вклада для получения
Возвращаемое значение
Promise<T>
getTeamContext()
Получает сведения о команде, на которую ориентирована страница
function getTeamContext(): ITeamContext
Возвращаемое значение
getUser()
Возвращает сведения о текущем пользователе
function getUser(): IUserContext
Возвращаемое значение
getWebContext()
Получение контекста о Интернете
function getWebContext(): IWebContext
Возвращаемое значение
IWebContext
init(IExtensionInitOptions)
Инициирует подтверждение с помощью окна узла.
function init(options?: IExtensionInitOptions): Promise<void>
Параметры
- options
- IExtensionInitOptions
Параметры инициализации расширения.
Возвращаемое значение
Promise<void>
notifyLoadFailed(string | Error)
Уведомляет узел о том, что расширение не удалось загрузить
function notifyLoadFailed(e: string | Error): Promise<void>
Параметры
- e
-
string | Error
Возвращаемое значение
Promise<void>
notifyLoadSucceeded()
Уведомляет узел о том, что расширение успешно загружено (остановите отображение индикатора загрузки)
function notifyLoadSucceeded(): Promise<void>
Возвращаемое значение
Promise<void>
ready()
Зарегистрируйте обратный вызов, который вызывается после завершения начальной установки или подтверждения. Если начальная настройка уже завершена, обратный вызов вызывается в конце текущего стека вызовов.
function ready(): Promise<void>
Возвращаемое значение
Promise<void>
register<T>(string, T)
Зарегистрируйте объект (метод экземпляра или фабрики), который этот расширение предоставляет кадру узла.
function register<T>(instanceId: string, instance: T)
Параметры
- instanceId
-
string
уникальный идентификатор зарегистрированного объекта
- instance
-
T
Либо: (1) экземпляр объекта или (2) функция, которая принимает необязательные данные контекста и возвращает экземпляр объекта.
resize(number, number)
Запрашивает родительское окно, чтобы изменить размер контейнера для этого расширения на основе текущего размера расширения.
function resize(width?: number, height?: number)
Параметры
- width
-
number
Необязательная ширина, по умолчанию для прокруткиWidth
- height
-
number
Необязательная высота, по умолчанию — scrollHeight
unregister(string)
Удаляет объект, предоставляемый этим расширением для кадра узла.
function unregister(instanceId: string)
Параметры
- instanceId
-
string
уникальный идентификатор зарегистрированного объекта
Сведения об переменной
sdkVersion
Номер версии веб-SDK. Можно задать в наборе требований расширения, например: vss-sdk-version/4.2
sdkVersion: 5
Тип
5