On this page: 
Target audience: Users of the extension providing HTML5/JavaScript support for Web applications. |
Summary: This document provides basic information about the extension providing HTML5/JavaScript support for Web applications. |
What's new in 1.7.0? - Support of JSX
- Added HTML5 code fragment
- New Quality Rules:
- Avoid unreferenced Functions
- Avoid undocumented Functions
- Avoid undocumented Classes
- Avoid High Response for Classes
- Avoid Artifacts with lines longer than X characters
- Avoid Functions having a very low Comment/Code ratio
- Avoid Artifacts with High Depth of Code
What's new in 1.7.1? - Bug fixing
- Impacts on analysis results after upgrade to 1.7.1:
- A bug has been discovered in previous releases if this extension which is causing XML configuration files for various frameworks to be included in statistics for the metric "Number of Code Lines - 10151". These XML configuration files should have been excluded from this metric. This bug has now been fixed and the XML configuration files are no longer taken into account for this metric, therefore after an upgrade to HTML5/JavaScript 1.7.1 and the generation of a post upgrade snapshot on the same source code, results may differ: the value for the "Number of Code Lines - 10151" metric will be lower.
|
Description
In what situation should you install this extension?
The analyzer could be used if your application is a Web Application, has HTML/Javascript/CSS files and/or contains HTML/Javascript fragments embedded into JEE and .NET files (for example).
The analyzer provides the following features:
- Automated Function Point counting.
- Checksum, number of code lines, number of comment lines, comments are present.
- Local and global resolution is done when function is called directly through its name (inference engine resolution is not available).
- For global resolution, caller is searched in all .js files. If only one callee is found, a link is created. If several callees are found, the analyzer watches inclusions in html files to see if it can filter the callee. If nothing is found in html files to filter, links are created to all possible callees.
Files analyzed
| Icon(s) | File | Extension | Note |
|---|
| | *.html, *.htm, *.xhtml | - Supports HTML/XHTML versions 1 - 5.
- creates one "HTML5 Source Code" object that is the caller of html to js links and a transaction entry point
- broadcasts tags and attributes/values to other CAST extensions such as AngularJS. Other extensions will not need to analyze the files themselves.
|
 | Javascript | *.js, *.jsx | Supports: - JavaScript 1 to 1.8.1.
- JavaScript ECMA 6
See also JavaScript below for more information. |
| Cascading Style Sheet | *.css | Supports CSS 1 - 3. |
| Java Server Page | *.jsp, *.jspx | Supports JSP 1.1 - 2.3. See JSP below for more information. |
| Active Server Page | *.asp, *.aspx | See (Classic) ASP below for more information. |
| HTML Components | *.htc | HTC files contain html, javascript fragments that will be parsed. Created objects will be linked to the HTC file. |
| ASP.NET MVC Razor | *.cshtml | See ASP.NET MVC Razor below for more information. |
Note that you may find that the number of files delivered is more than then number of files reported after analysis. This is due to the following: - by default some files are automatically excluded from the analysis, typically third-party frameworks which are not required. Please see the filters.json file located at the root of the extension folder for a complete list of default exclusions.
- some files that have been included in the analysis may not be saved in the CAST Analysis Service schema because they do not contain any useful information, i.e. they do not contain any technical sections such as functions which would lead to the creation of a specific object.
|
Technology support notes
(Classic) ASP
ASP.NET MVC Razor
JavaScript
CAST AIP has provided support for analyzing JavaScript via its JEE and .NET analyzers (provided out of box in CAST AIP) for some time now. The HTML5/JavaScript extension also provides support for JavaScript but with a focus on web applications. CAST highly recommends that you use this extension if your Application contains JavaScript and more specifically if you want to analyze a web application, however you should take note of the following when using the extension with CAST AIP ≤ 8.2.x - You should ensure that you configure the extension to NOT analyze the back end web client part of a .NET or JEE application.
- You should ensure that you configure the extension to ONLY analyze the front end web application built with the HTML5/JavaScript that communicates with the back end web client part of a .NET or JEE application.
- If the back end web client part of a .NET or JEE application is analyzed with the HTML5/JavaScript extension and with the native .NET/JEE analyzers, then your results will reflect this - there will be duplicate objects and links (i.e. from the analyzer and from the extension) therefore impacting results and creating erroneous Function Point data.
| Note that in CAST AIP ≥ 8.3.x, support for analyzing JavaScript has been withdrawn from the JEE and .NET analyzers. |
Support of JavaScript in this extension - JavaScript (1 to 1.8.1):
- Javascript call(), function(), bind(), prototype and prototype inheritance are supported
- creates Functions, Classes and Constructors
- local call links between function calls and functions inside each JavaScript file are created
|
JSP
Transaction configuration information
HTML5 source code: it represents the whole HTML file content.
Function Point, Quality and Sizing support
This extension provides the following support:
- Function Points (transactions): a green tick indicates that OMG Function Point counting and Transaction Risk Index are supported
- Quality and Sizing: a green tick indicates that CAST can measure size and that a minimum set of Quality Rules exist
Function Points
(transactions) | Quality and Sizing | Security |
|---|
 | | |
CAST AIP compatibility
This extension is compatible with:
| |
|---|
| 8.3.x | |
| 8.2.x | |
| 8.1.x | |
| 8.0.x | |
| 7.3.4 and all higher 7.3.x releases | |
Supported DBMS servers
This extension is compatible with the following DBMS servers:
| CAST AIP release | CSS | Oracle | Microsoft |
|---|
| All supported releases | | |  |
Prerequisites
| An installation of any compatible release of CAST AIP (see table above) |
Download and installation instructions
Please see:
Packaging, delivering and analyzing your source code
Once the extension is downloaded and installed, you can nowpackage your source code and run an analysis. The process of packaging, delivering and analyzing your source code is described below:
What results can you expect?
Once the analysis/snapshot generation has completed, you can view the results in the normal manner:
CAST Enlighten
Javascript ECMA6 Classes and Constructors example
CAST Management Studio analysis content
Objects
The following objects are displayed in CAST Enlighten:
| Icon | Description |
|---|
| JavaScript file |
| HTML5 Source Code |
| HTML5 Source Code Fragment |
| HTML5 ASP Content |
| HTML5 ASPX Content |
| HTML5 CSHTML Content |
| |
| HTML5 CSS Source Code Fragment |
| HTML5 HTC Content |
| HTML5 JavaScript Source Code |
| HTML5 JSX source code |
| HTML5 JavaScript Source Code Fragment |
| HTML5 JavaScript Function |
| HTML5 Javascript Method |
| HTML5 Javascript Class |
| HTML5 Javascript Class Constructor |
| HTML5 Web Socket Service ASP.NET Any Operation |
| HTML5 Get XMLHttpRequest Service HTML5 Get HttpRequest Service ASP.NET Get Operation HTML5 Razor Get service |
| HTML5 Update XMLHttpRequest Service HTML5 Update HttpRequest Service ASP.NET Put Operation |
| HTML5 Post XMLHttpRequest Service HTML5 Post HttpRequest Service ASP.NET Post Operation HTML5 Razor Post service |
| HTML5 Delete XMLHttpRequest Service HTML5 Delete HttpRequest Service ASP.NET Delete Operation |
Rules
The list of rules is available here:
Known Limitations
- Creation and detection of object using "prototype" is not supported
