14  * An instance of the SourceMapGenerator represents a source map which is
18  *   - file: The filename of the generated source.
19  *   - sourceRoot: A root for all relative URLs in this source map.
56       if (mapping.source != null) {
57         newMapping.source = mapping.source;
59           newMapping.source = util.relative(sourceRoot, newMapping.source);
93  * Add a single mapping from original source line and column to the generated
94  * source's line and column for this source map being created. The mapping
99  *   - source: The original source file (relative to the sourceRoot).
106     var source = util.getArg(aArgs, 'source', null);
110       this._validateMapping(generated, original, source, name);
113     if (source != null) {
114       source = String(source);
115       if (!this._sources.has(source)) {
116         this._sources.add(source);
132       source: source,  property
138  * Set the source content for a source file.
142     var source = aSourceFile;
144       source = util.relative(this._sourceRoot, source);
148       // Add the source content to the _sourcesContents map.
153       this._sourcesContents[util.toSetString(source)] = aSourceContent;
155       // Remove the source file from the _sourcesContents map.
157       delete this._sourcesContents[util.toSetString(source)];
165  * Applies the mappings of a sub-source-map for a specific source file to the
166  * source map being generated. Each mapping to the supplied source file is
167  * rewritten using the supplied source map. Note: The resolution for the
170  * @param aSourceMapConsumer The source map to be applied.
171  * @param aSourceFile Optional. The filename of the source file.
173  * @param aSourceMapPath Optional. The dirname of the path to the source map
175  *        This parameter is needed when the two source maps aren't in the same
176  *        directory, and the source map to be applied contains relative source
177  *        paths. If so, those relative source paths need to be rewritten
187           'SourceMapGenerator.prototype.applySourceMap requires either an explicit source file, ' +
188           'or the source map\'s "file" property. Both were omitted.'
205       if (mapping.source === sourceFile && mapping.originalLine != null) {
206         // Check if it can be mapped by the source map, then update the mapping.
211         if (original.source != null) {
213           mapping.source = original.source;
215             mapping.source = util.join(aSourceMapPath, mapping.source)
218             mapping.source = util.relative(sourceRoot, mapping.source);
228       var source = mapping.source;
229       if (source != null && !newSources.has(source)) {
230         newSources.add(source);
261  *   2. The Generated position, original position, and original source.
262  *   3. Generated and original position, original source, as well as a name
300         source: aSource,  property
309  * specified by the source map format.
350       if (mapping.source != null) {
351         sourceIdx = this._sources.indexOf(mapping.source);
379     return aSources.map(function (source) {  argument
384         source = util.relative(aSourceRoot, source);
386       var key = util.toSetString(source);
394  * Externalize the source map.
418  * Render the source map being generated to a string.