mirror of
https://github.com/gosticks/DefinitelyTyped.git
synced 2026-07-01 15:50:13 +00:00
Update angular-sanitize types for angular 1.7 (#36169)
This commit is contained in:
Michał Lipiński
committed by
Ben Lichtman
Ben Lichtman
parent
f393e617ac
commit
b729e2201f
@@ -1,9 +1,29 @@
|
||||
var shouldBeString: string;
|
||||
var shouldBeBoolean: boolean;
|
||||
var shouldBeSanitizeProvider: ng.sanitize.ISanitizeProvider;
|
||||
|
||||
declare var $sanitizeProvider: ng.sanitize.ISanitizeProvider;
|
||||
shouldBeSanitizeProvider = $sanitizeProvider.enableSvg(true);
|
||||
shouldBeBoolean = $sanitizeProvider.enableSvg();
|
||||
shouldBeSanitizeProvider = $sanitizeProvider.addValidElements(['div']);
|
||||
shouldBeSanitizeProvider = $sanitizeProvider.addValidElements({
|
||||
htmlElements: ['div']
|
||||
});
|
||||
shouldBeSanitizeProvider = $sanitizeProvider.addValidElements({
|
||||
htmlElements: ['div'],
|
||||
htmlVoidElements: ['img']
|
||||
});
|
||||
shouldBeSanitizeProvider = $sanitizeProvider.addValidElements({
|
||||
htmlElements: ['div'],
|
||||
htmlVoidElements: ['img'],
|
||||
svgElements: ['g']
|
||||
});
|
||||
shouldBeSanitizeProvider = $sanitizeProvider.addValidAttrs(['class']);
|
||||
|
||||
declare var $sanitizeService: ng.sanitize.ISanitizeService;
|
||||
shouldBeString = $sanitizeService(shouldBeString);
|
||||
|
||||
declare var $linky: ng.sanitize.filter.ILinky;
|
||||
shouldBeString = $linky(shouldBeString);
|
||||
shouldBeString = $linky(shouldBeString, "target");
|
||||
shouldBeString = $linky(shouldBeString, 'target');
|
||||
shouldBeString = $linky(shouldBeString, shouldBeString);
|
||||
|
||||
71
types/angular-sanitize/index.d.ts
vendored
71
types/angular-sanitize/index.d.ts
vendored
@@ -1,6 +1,7 @@
|
||||
// Type definitions for Angular JS (ngSanitize module) 1.3
|
||||
// Type definitions for Angular JS (ngSanitize module) 1.7
|
||||
// Project: http://angularjs.org
|
||||
// Definitions by: Diego Vilar <https://github.com/diegovilar>
|
||||
// Michał Lipiński <https://github.com/falsyvalues>
|
||||
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
||||
// TypeScript Version: 2.3
|
||||
|
||||
@@ -12,16 +13,62 @@ import * as angular from 'angular';
|
||||
declare module 'angular' {
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
// ngSanitize module (angular-sanitize.js)
|
||||
// see https://code.angularjs.org/1.7.0/docs/api/ngSanitize
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
namespace sanitize {
|
||||
///////////////////////////////////////////////////////////////////////////
|
||||
// SanitizeService
|
||||
// see http://docs.angularjs.org/api/ngSanitize.$sanitize
|
||||
///////////////////////////////////////////////////////////////////////////
|
||||
/**
|
||||
* Sanitizes an html string by stripping all potentially dangerous tokens.
|
||||
*
|
||||
* The input is sanitized by parsing the HTML into tokens.
|
||||
* All safe tokens (from a whitelist) are then serialized back to a properly escaped HTML string.
|
||||
* This means that no unsafe input can make it into the returned string.
|
||||
*
|
||||
* The whitelist for URL sanitization of attribute values is configured using the functions aHrefSanitizationWhitelist and imgSrcSanitizationWhitelist of $compileProvider.
|
||||
* The input may also contain SVG markup if this is enabled via $sanitizeProvider.
|
||||
*
|
||||
* @param html HTML input.
|
||||
*/
|
||||
interface ISanitizeService {
|
||||
(html: string): string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates and configures $sanitize instance.
|
||||
*/
|
||||
interface ISanitizeProvider {
|
||||
/**
|
||||
* Enables a subset of svg to be supported by the sanitizer.
|
||||
*
|
||||
* @see https://code.angularjs.org/1.7.0/docs/api/ngSanitize/provider/$sanitizeProvider#enableSvg
|
||||
* @param flag Enable or disable SVG support in the sanitizer.
|
||||
*/
|
||||
enableSvg(): boolean;
|
||||
enableSvg(flag: boolean): ISanitizeProvider;
|
||||
enableSvg(flag?: boolean): boolean | ISanitizeProvider;
|
||||
|
||||
/**
|
||||
* Extends the built-in lists of valid HTML/SVG elements, i.e. elements that are considered safe and are not stripped off during sanitization.
|
||||
*
|
||||
* You can extend the following lists of elements:
|
||||
* htmlElements: A list of elements (tag names) to extend the current list of safe HTML elements. HTML elements considered safe will not be removed during sanitization. All other elements will be stripped off.
|
||||
* htmlVoidElements: This is similar to htmlElements, but marks the elements as "void elements" (similar to HTML void elements). These elements have no end tag and cannot have content.
|
||||
* svgElements: This is similar to htmlElements, but for SVG elements. This list is only taken into account if SVG is enabled for $sanitize.
|
||||
*
|
||||
* @see https://code.angularjs.org/1.7.0/docs/api/ngSanitize/provider/$sanitizeProvider#addValidElements
|
||||
* @param elements A list of valid HTML elements or an object with one or more of the following properties: htmlElements, htmlVoidElements, svgElements
|
||||
*/
|
||||
addValidElements(elements: string[] | { htmlElements?: string[]; htmlVoidElements?: string[]; svgElements?: string[] }): ISanitizeProvider;
|
||||
|
||||
/**
|
||||
* Extends the built-in list of valid attributes, i.e. attributes that are considered safe and are not stripped off during sanitization.
|
||||
*
|
||||
* Note: The new attributes will not be treated as URI attributes, which means their values will not be sanitized as URIs using $compileProvider's aHrefSanitizationWhitelist and imgSrcSanitizationWhitelist.
|
||||
* @see https://code.angularjs.org/1.7.0/docs/api/ngSanitize/provider/$sanitizeProvider#addValidAttrs
|
||||
* @param attrs A list of valid attributes.
|
||||
*/
|
||||
addValidAttrs(attrs: string[]): ISanitizeProvider;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////////////
|
||||
// Filters included with the ngSanitize
|
||||
// see https://github.com/angular/angular.js/tree/v1.2.0/src/ngSanitize/filter
|
||||
@@ -29,22 +76,22 @@ declare module 'angular' {
|
||||
export namespace filter {
|
||||
/**
|
||||
* Finds links in text input and turns them into html links. Supports http/https/ftp/mailto and plain email address links.
|
||||
* @see https://code.angularjs.org/1.7.0/docs/api/ngSanitize/filter/linky
|
||||
* @param text Input text.
|
||||
* @param target ILinkyTargetType Window (_blank|_self|_parent|_top) or named frame to open links in.
|
||||
* @param attributes Add custom attributes to the link element.
|
||||
* @return Html-linkified and sanitized text.
|
||||
* see https://docs.angularjs.org/api/ngSanitize/filter/linky
|
||||
*/
|
||||
interface ILinky {
|
||||
(text: string, target?: string, attributes?: { [attribute: string]: string } | ((url: string) => { [attribute: string]: string })): string;
|
||||
}
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
// Extend angular $filter declarations to include filters from angular.sanitize module
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
interface IFilterService {
|
||||
(name: 'linky'): angular.sanitize.filter.ILinky;
|
||||
}
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
// Extend angular $filter declarations to include filters from angular.sanitize module
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
interface IFilterService {
|
||||
(name: 'linky'): angular.sanitize.filter.ILinky;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user